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PART I 



INTRODUCTION 



SECTION 1.0 GENERAL BACKGROUND INFORMATION 



IS a 



Datapoint Corporation's Disk Operating System, (usually abbreviated DOS) 
comprehensive system of facilities for sophisticated data management. 

The DOS provides the operator with a powerful set of system commands by which the 
operator can control data movement and processing from the system console. These 
commands allow the system operator to accomplish in a very short time thmgs which would 
.)e substantially more difficult on much larger computing systems. Sorting a large file for 
-r stance, can generally be accomplished in one single command line: compare this with the 
oewHdenng pile of system commands required to perform the similar function on other 
machines. In spite of the simplicity of operation, even the most sophisticated users will be 
surprised at the wide range and versatility of features provided. 

To the programmer, DOS offers a large set of facilities to enable programs to execute 
without detailed knowledge of the particular disk in use. Such advanced concepts as 
completely dynamic disk space allocation allow programs to efficiently operate without regard 
c the amount of space required for the data files they are using. In addition, the very 
efficient disk file structure used by the DOS allows for direct random access to data files at 
speeds comparing very favorably with even the largest mainframes. The standard use of fully 
space-compressed text files allow source programs and many data files to fit in half or less of 
the disk space that would normally be required on larger systems. 

For the systems analyst and systems designers, DOS provides the solid foundation for 
powerful and sophisticated packages such as Datapoint Corporation's highly successful 
DATASHARE system. 

Programmers and operators alike will appreciate the automatic program chaining facility 
provided by the CHAIN command of the DOS. Programmers will enjoy using CHAIN because 
t enables the creation of complete, sophisticated job files which allow the automatic execution 
of an almost unlimited number of job steps, all without operator if.tervention at the 
Keyboard. Ease of assembling or compiling a large system of programs is just one of the 
many benefits achieved by chaining. Operators will appreciate CHAIN because entire data 
processing tasks can be queued for execution and invoked with only a single command line to 
the system. 

These features, combined with the ability to support up to 200 million bytes of 
high-speed random access disk storage, provide the Datapoint user with a full range of data 
processing capabilities unmatched by any comparable business-oriented system. 
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1.1 Hardware Support Required 

The minimal configuration required to run the DOS is a Datapoint computer, (any of 
series 5500, 2200, or 1100) with minimum 16K of memory, and one disk storage unit (any of 
series 9370, 9350 or 9380). For backup and support purposes, users with the Diskette 1100 
computer are required to have at least one system with more than one diskette drive. Users 
with the other processors can operate with only a single disk drive unit in conjunction with 
the integral tape cassettes, but for backup and system support purposes a two-drive system is 
a strongly recommended minimum. 

1.2 Software Configurations Available 

The DOS is provided in serveral different versions. Different versions are used 
depending upon the type of disk in use at an installation. Specific versions are indicated by a 
letter after a period in the name of the DOS. As an example, the tollowing versions of the 
DOS are currently defined: 

DOS.A -- Supports 9350 series disk drives on Datapoint 2200 and 5500 series computers. 

DOS.B -- Supports. 9370 series disk drives on Datapoint 2200 and 550G series computers. 

DOS.C -- Supports 9380 series disk drives on Datapoint 1100. 2200 and 5500 series 
computers. 

This manual describes the compatible set of facilities available to the DOS user within 
the the Disk Operating System. Programs written in any of the supported higher level 
languages (Databus 7, DOS Databus, Datashare, RPG 11, BASIC, etc.) will generally run 
unmodified on any of the Datapoint Corporation DOS. Programs w'itten in Assembler 
Language will also run under any of the DOS. without reassembly. 

Basically, in only a few isolated cases will another program need to be changed when 
it is transferred from one DOS to another. The need for program modification, which should 

nhv/inii<;lv/ hp i^woiHoH whonov/pr onccihio will iiciipllv/ Qtpm from nnp or morP nf thp followina 

types of situations: 

1) Programs which make assumptions regarding the size of ihe file they are dealing 
with. For example, programs originally written for the 9350 series disks might assume that 
the size of the biggest possible file could be expressed as four ASCI! digits. Under DOS.B. 
this assumption is invalid since files under DOS.B may be up to 30,238 data sectors long. 

2) Programs which make assumptions regarding the physical structuring of the data on 
the disks. For example, different DOS allocate space on the disk in pieces of different sizes, 
and may place their system tables in different locations on the disk. 

3) Programs which generate or modify physical disk addresses themselves. Since the 
disks are each organized somewhat differently to take advantage of the particular 
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characteristics of the specific type of drives involved, the physical disk address formats 
naturally vary among different DOS. 

4) Programs which rely upon other characteristics of the DOS which are not 
documented in this manual. A possible situation would be where a user might look at the 
values in the registers following the return from a system routine and determine, for instance. 
that some routine always seemed to return with the value '1' in one of the registers, if he 
then constructs his program in such a manner that it will not function correctly if the '1' is 
not present upon return from the routine, then he is obviously liKely to find that his program 
will not work properly on a different DOS. 

All of the above situations except for the first will usually only occur in Assembler 
Language programs operating at the very lowest levels. Users which for their application 
require programs which operate with this level of detailed knowledge about the DOS will find 
the information specific to that DOS in the DOS System Manual corresponding to the DOS 
they are using. 

The DOS System Manual for a specific DOS is also the place where a user will 
normally turn for operational details and information about the hardware and software specific 
to his particular DOS. For example, the commmand INIT9370 {to format a disk volume for 
use in the 9370 series disk drives) is described in the DOS.B System Manual, since it is 
clearly not applicable to users of the 9380 series flexible diskette drives. 
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SECTION 2.0 OPERATOR COMMANDS 



All Datapoint computers include, as a standard feature, an integral CRT display unit by 
which the internal computer communicates with the user. The system console also includes 
a typewriter-style keyboard which the user employs to communicate with the computer. The 
Disk Operating System is normally controlled by commands typed by the user at this system 
console. 

When the DOS first 'comes up', (computer jargon for 'become ready for commands'.) it 
displays a message on the CRT and says 'READY'. At this point the DOS is ready to accept 
a command line. This command line, typed by the user, tells the DOS which program the 
user wants to run and will generally also name one or more f/7es on disk which the program 
is to use. These files could be program files (files containing programs in one form or 
another) or data files (files containing data to be used by executing programs). If. as an 
example, the user wished to edit a program file on his disk, ha would simply type 

EDIT PROGNAME 

where 'PROCSNAME' is the name of his program. EDIT is a standard DOS command which 
allows the user to edit files stored on the disk. 

A Iarg6 assortment of useful commands Is provided with the DOS. These include the 
DOS editor and many useful disk file handling commands. A complete set of CTOS 
compatible cassette handling commands are also provided, allowing the user to transfer files 
between the disk and cassettes. 

Since the commands are actually programs which the system loads and executes to 
perform the task required, the command language is naturally extensible to include any 
program the user may desire, thus leading to a powerful keyboard facility. See Part III for 
information on the commands supplied with the system. 
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SECTION 3.0 FILES 



Each of the DOS-supported disks stores information in the form of sectors, each of 
which contains 256 bytes of information. Each byte is capable of storing one ASCII (or 
EBCDIC) coded character. Information stored in these sectors is usually grouped with a 
number of other sectors containing related information, and together this group is referred to 
cis a file. 

3.1 FILE NAMES 

Files are identified from the console by a NAf^E, EXTENSION, and LOGICAL DRIVE 
NUMBER. The NAME must start with a letter and may be followed by up to seven 
alphanumeric characters. Examples of typical file names are: 

EDIT 

PAYROLL 

EMPLOYEE 

JUL1075 

MONDAY 

LEDGER 

etc 

The EXTENSION must start with a letter and may be followed by up to two 
alphanumeric characters. It further defines the file, usually indicating the type of information 
contained therein. For example, TXT usually Implies user data files or source information 
(e.g. DATASHARE, ASM, DOS DATABUS, or SCRIBE source lines), ABS usually implies 
program object code records that can be loaded by the system loader, and CMD usually 
implies programs that implement commands given the DOS from ihe keyboard. Most 
commands have default assumptions concerning the extensions of the file names supplied to 
them as parameters. However, extensions may otherwise be considered as an additional part 
of the name. The LOGICAL DRIVE NUMBER specifies which logical drive is to be used. It 
is given in the form DR(n), where (n) is zero through the maximum supported within the 
users configuration and the specific DOS he is using. If the drive is not specified, the 
system searches all drives starting with zero. Note that each logical drive contains its own 
directory structure. Specifying the drive number enables one to keep programs of the same 
NAME and EXTENSION on more than one drive. In addition, specifying a logical drive 
allows the user to place files on any logical drive of his choice. 

3.2 FILE CREATION 

Files are always created implicitly. That is. the operator never specifically instructs the 
system to create a given file. Certain commands create files from the names given as the;; 
parameters. Since space allocation is dynamic, the operator never specifies how many 
'ecords his file will contain. 
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3.3 FILE DELETION 

Deleting files is made somewhat more difficult to protect the user from accidentally 
destroying valuable data. Files can be protected against deletion or both deletion and 
writing. In addition to this, the operator must always explicitly name the file he is deleting 
and even then must answer a verification check stop before the actual deletion occurs. 

For example, assume the user wished to delete an old copy or a program on his disk 
named OLDPROG/ABS. Although he would of course type his commands and replies in 
upper case, they are shown in lower case for clarity in the following example: 

kill oldprog/abs 
ARE YOU SURE? yes 
♦FILE DELETED * 
READY 

3.4 PROGRAM EXECUTION 

The system has no explicit RUN command since, to execute his program, the user 
simply mentions its name as the first file specification on the command line. This is the 
mechanism via which both commands and user programs alike are executed. The first file 
specification may be followed by up to three more, depending upon the requirements for 
parameterization of the program being run. A file specification is of the form: 

NAME/EXTENSION:DRIVE 

where any of the three items may be null (except the NAME must be given in the first 
specification which denotes the program to be run). Note that the / indicates that an 
extension follows and the : indicates that a drive specification follows. If either of these 
items is not given, the corresponding delimiting character is not used For example: 

NAME/ABS:DRO NAME/ABS 



I Mr-ttvi i_ . i_/i i<^ 



NAME 

are all syntactically correct. File specifications may be delimited by any non-alphanumeric 
that would not be confused with the extension and device indicators. For example: 

COPY NAME/TXT,NAME/ABS 
COPY NAME/TXT NAME/ABS 
COPY NAME/TXT/NAME/ABS 

will a{\ perform the same function. If an extension is not supplied in the first file 
specification, it will be assumed to be CMD. In the above examples, COPY/CMD will be 
used for the complete file name sought in the directory for the command program name. 
Note that if one wanted to run a file he had created with extension ABS, he would simply 
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enter 

NAME/ABS 



2llTn?r r"' '" '°'''' ""' "'"^^*"^- '^ *^^ name given cannot be found in the 
directory or directories specified, the message 

WHAT? 

r.'l^r ^'^P'^y^d Note that the DOS can load any object code at or above location 01000 

1 2... nrrr^ '\r^ "'^ ^^' ^^"^ '"^^^ °^ '^' ''^'^'^P' ^^"^''"5 ^^^'''^y- 'oading must 
L TnT.T ""' '^'^^"^ "^^'^ ^^ bootstrapped (by pushing RESTART) before 01000 

^'^''^f 01377 may be overstored. This restriction arises from the fact that once the interrupt 
acuity has been activated, a JUMP to a routine between 01000 and 01377 has been stored m 
locations 0, 1 and 2 and if this routine is overstored, the system will go astray upon 
occurrence of the next interrupt. 

>K .^^^ST '" °^ *^'^ "'^""^' ^°' ^ ^"" description of the command programs supplied 
With the DOS. 
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PART II 



SYSTEM GENERATION 



SECTION 1. GENERAL BACKGROUND INFORMATION 



Upon initial installation of a new Datapoint disk-oriented dispersed processing system the 
user w. I generally start off with several brand new disks. Before these d'sks can be used' b 
^^ Disk Operating System, however, the disks must be prepared; this process is known as 
DOS generation or DOSGEN-ning the new disk. 

Some types of disks require special treatment even before a DOSGEN can be properly 
done on them. One example is disks that are used with the Datapoint 9370-series disk 
dnves.On these disks, formatting information must first be written onto the disk. Such special 
reatment to be done before the DOSGEN process Is described in the DOS System Manual for 
the specific DOS in use; only the general-case DOSGEN process will be described here. 

nnT'^ ^'^ ^""^ methods for doing a DOSGEN on a disk. They differ primarily by whether 
the DOS IS generated from the very beginning (e.g. from a casseite tape running under CTOS) 
or from an up and running DOS system. Users doing their very first DOSGEN or having only 
one physical disk drive will have to DOSGEN using the cassette DOSGEN 
approach; otherwise they will be able to use the generally faster disk DOSGEN command 
supplied with the DOS and described later. 
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SECTION 2. DOSGEN FROM CASSETTE 



whioh^^nT"^ ?K^^^^'^ '^'""'^' *^^* *^^ ""^'' ^^^^ ^ DOS Generation cassette package 
which contains the DOS to be generated, and a disk to generate the DOS onto. 

Each physical disk drive has a number associated with it, which is called the physical 
drive number. At the time the hardware is installed, the Datapoint Customer Service engineer 
w. instruct the user in the proper technique for inserting and removing disks from the users 
di.k drives and will indicate which numbers are associated with which physical disk drives. 

The two cassette tape drives on top of Datapoint computers (that are so equipped) are 
usually referred to as the from deck and the rear deck. The rear deck is the one physically 
closer to the row of cooling slots on the top of the computer and toward the back. In disk 
onented systems, this rear deck is almost invariably used to hold a tape known as the DOS 
boot tape, use of which will be described later on in this part of the manual. The front 
deck IS the deck physically closer to the user as he sits at the processor keyboard. In disk 
onented systems, this front deck is almost invariably used to hold cassettes which either 
contain data to be input into the system through the use of one or more of the available 
system commands, or blank cassettes to which data can be output via appropriate system 
commands. 

n^cr^'^""^^^' ""^ *^^ important hardware things a person needs to know about before his first 
DOSGEN is the read-only switch present on the 9350 and 9370 series disk drives (There is 
such a switch on the 9380 series drives also, but on these the switch is internal to the 
controller and for Service Engineering use only). This switch is usually labelled with 
something descriptive such as 'Read-write/Read only' or Protect'. These switches physically 
prevent the disk controller from writing on the disk. Since the DOSGEN process obviously 
needs to write on the disk (as do most operations under the DOS) it is. important that these 
switches be set to allow writing. In order to allow writing on the 9370-series drives the 
switch must be pushed to 'Read-write'. For the 9350-series drives, pressing the 'Protect' 
switch will cause the light inside it to be extinguished indicating that writes will be permitted 
(More information on the slightly unorthodox behavior of the write disable switch on the 9370 
disks will be given in the DOS.B System Guide). 

After the disks are in place and spinning and the DOSGEN cassette is in place in the 
rear deck, load the DOSGEN program from the rear deck by pressing the key on the computer 
Keyboard marked 'Restart'. (Datapoint 5500 users must also press 'Run' at the same time as 
Restart' for the 'Restart' key to have effect). If the tape stops moving and the 'Stop' light 
comes on (the light at the left side of the 'Stop' key) then the tape probably did not load 
correctly. Usually this will occur within about 5-10 seconds after the tape is rewound and 
starts moving forward. If this halt occurs, the procedure should be repeated as necessary If 
after several tries the DOSGEN program still does not come up, the tape may be bad and 
should be replaced. 

When the program has loaded, it will display a message identifying itself and ask the 
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user several questions to determine that the user is not going to accidentally overwrite a disk 
containing valuable information. As each question is asked, the user is required to key in his 
answer (usually 'Y' or 'N' is sufficient) and terminate his response with the 'Enter' key. (By 
DOS convention almost all entries to questions posed by progran(S are terminated by 'Enter'). 

After a time the program will ask if the user wants to lock ouf any cylinders. If the user 
wants to set aside an area of the disk for abnormal use, (or wishes to prevent the use of a 
portion of the disk which may be bad) then he should reply 'Y' to this message. In this case 
the user is asked which cylinders he wishes to lock out; the reply should be of the format 
described for the DOSGEN command as detailed in Part III of this manual. However, the 
normal answer to this question will be 'N'. 

Following this, the disk is checked for obvious bad spots and these places are then 
automatically locked out. When the surface checking has finished, the DOS and a few 
commands are copied, to the disk. When enough of the DOS has been copied to the disk to 
bring the system up, the DOS is brought up and the standard DOS signon message and 
'READY' are displayed. 

Important: The DOSGEN procedure is not completed until the commands have been 
loaded onto the disk. Specifically, one of the files on the commands tape, named 
SYSTEM7/SYS, must be loaded before the DOS will operate properly. 

Before loading the commands, first place a blank cassette in the front deck and type 
'BOOTMAKE' at the console. Follow the instructions that are subsequently displayed and a 
DOS 'Boot block' will be written onto the front tape. It is probably a good idea to repeat this 
process several times to ensure getting a good boot tape before proceeding. These boot 
tapes are the mechanism by which the DOS is 'brought up'. 

The next step is to load the commands. Place the first of the commands tapes into the 
front deck. The message 'READY' should at this point appear on the display. If it does not. 
take one of the boot tapes generated in the previous step, place it- into the rear deck and load 
it just like the DOSGEN tape. After several seconds the DOS signon and 'READY' should 
appear. If they do not and the 'Stop' light comes on. try another of the boot tapes you have 
just made until the 'READY' message is displayed. Then, with the commands tape in the front 
deck, enter: 

MIN ;A0 

at the console. The MIN program will be loaded from the disk into memory and will proceed 
to load the commands into the system and store them onto the disk. When the tape has been 
fully loaded and the message TvlULTIPLE IN COMPLETED' and 'READY' are displayed, remove 
the front tape (turning it over if necessary) and proceed to load the second tape of commands 
(which in some cases will be the second side of the same tape, or ccuid be a completely 
separate tape; the labels on the cassettes will indicate which is the case with your particular 
tapes). When all the commands have been loaded (usually two or perhaps three cassette 
sides) the DOS generation procedure on the specified logical drive is complete. 

Note that on some types of drive, notably the 9370-series ('Mass Storage') disk drives. 
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each of the two logical disks on each disk pack must be D0SGE^4ed individually (i.e. the 
DOSGEN procedure must be done twice before the physical disk is completely DOSGENed). 
The second DQSGEN for such users should be done after generating the boot tapes and 
before using MIN to load the commands. 

After a disk has been fully DOSGENed in this manner, the user can then (assuming he 
has two physical disk drives) use the faster DOSGEN command to DOSGEN subsequent 
disks.The use of the DOSGEN command is described in Part III of this manual. 

The DOSGEN program allows the user to specify on which disk the DOSGEN is to take 
place. In spite of this, it is important to recognize that the DOS must be resident on logical 
drive zero at an intermediate point in the DOSGEN procedure; therefore, the first DOSGEN 
done must be onto drive zero in order that a DOS be there when required. Subsequent 
DOSGENs can be onto any other drive, as long as drive zero then contains a fully DOSGENed 
disk. 
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SECTION 1. APP COMMAND 



APP - Append two object files creating a third 

APP <fj|e spec>,{<file spec>},<file speo 

The APP command appends the second object file after the first and puts the result into 
the third file. If extensions are not supplied, ABS is assumed. The first two files must exist. 
If the third file does not already exist, a new file will be created. The first file's end of file 
record is discarded and the copy is terminated by the end of file mark in the second file. 

Omitting the second file specification causes the first file to be copied into the third file, 
^or example: 

APP DOG„CAT 

will copy the file DOG/ABS Into the file CAT/ABS. Note that neither of the first two files will 
be disturbed. 

The first and third file specifications are required. If either is omitted the message 

NAME REQUIRED 

will be displayed. The second and third file specifications must not be the same. 
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SECTION 2. AUTO COMMAND 



AUro - Set Auto Execution 
AUTO <file speo 

The AUTO command specifies which program is to be automatically executed upon initial 
loading of the system. If no extension is supplied, ABS is assumed. If there is already a file 
set for auto execution, the message 

AUTO WAS SET TO NAME/EXTENSION (PFN). 

will be displayed (where PFN is the physical file number). Regardless, the name specified will 
be recorded in the directory location reserved for the auto-execution name. No check is made 
to see if the file is an object file. 

If no file spec if given In the commmand line, then the setting of the file to be 
AUTO-executed is not changed. However, if a file spec was present, then the message: 

AUTO NOW SET TO NAME/EXTENSION (PFN). 
will be displayed after the new AUTO-execution setting has been made. 

If no <file spools entered and AUTO is not set, the message 

NAME REQUIRED 
will be displayed. If the <file speodoes not exist, the message 

NO SUCH NAME 

will be displayed. Note that if a program has been set to auto-execute, its execution can be 
inhibited by depression of the KEYBOARD key when the system is reloaded. 

Note that the AUTO command does not make provision for file specifications to be given 
to the program which is to be automatically executed. This makes it impossible to use AUTO 
for programs requiring such parameters. For more information, refer to the section describing 
the AUTOKEY command. 
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SECTION 3. AUTOKEY COA^MAND 



3.1 Introduction to AUTOKEY. 

Many users allow their Datapoint computers to run in an unattended mode. This allows 
large data processing tasks, perhaps running via the DOS command chaining facility (see 
CHAIN), to be run during the evening hours when no operator is present. (An example might 
be the creation of several new index files for one or more large, I SAM -accessed data bases). 
However, the momentary power failures which data processing users are being forced to 
contend with during times of shortage, thunderstorms and the like can bring down any 
computer not having special, uninterruptible power supplies. When this happens to a computer 
running in unattended mode, the office staff will generally return the next morning to find their 
computer sitting idle and its work unfinished. 

The Datapoint computers are all equipped with an automatic-restart facility which can be 
used to cause them to automatically resume their processing tasks following such an 
interruption. The purpose of the AUTOKEY (and AUTO) commands in the DOS are to provide 
a software mechanism for use by programmers who wish to handle such unusual 
circumstances and provide for the restarting of a processing task. 

3.2 The Hardware Auto-Restart Facility. 

There are two little tabs on the back edge (the edge directly opposite from the edge the 
tape is visible on) of each cassette tape. The leftmost of these (as you look at the top side of 
the cassette) is the write protect tab, which prevents writing on the topmost side of the tape. 
The right-hand tab is the auto-restart tab. 

Users who frequently use both sides of cassettes will probably immediately notice that if 
one turns over the tape, the assignments of these two tabs switch around, the tab which had 
been write protect now being auto restart and vice versa. This in fact is precisely what 
happens. 

If the auto-restart tab on the rear cassette is punched out (or slid to the side on the 
newer cassettes), then the computer will automatically re-boot, just like it does when RESTART 
is depressed, whenever it detects that it has halted. Assuming that the rear cassette drive 
contains a DOS boot tape, this will cause the DOS to come up and give its familiar message, 
'READY'. 

3.3 Automatic Program Execution using AUTO. 

In order to provide a mechanism for programs to resume automatically following an 
interruption (such as a DATASHARE system, for instance, which might be running unattended) 
the DOS has a comparable facility to enable a program to be automatically executed whenever 
the DOS comes up. (Note that any loading and running the DOS, whether by an auto-restart, 
hitting the RESTART key, or under program control, will activate this facility). 
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The AUTO command is used to establish a program to receive control when the DOS 
comes up. This setting can be cleared with the MANUAL command. For some applications, 
the AUTO and MANUAL commands are adequate to allow a programmed restart of a lengthy 
data processing task. However, some programs require parameters be specified on the 
command line, and these are obviously not present if no command line has been typed in. 

3.4 Auto-Restart Facilities using AUTOKEY. 

AUTOKEY is simply a command program which can be AUTO'd. The way in which it 
works is very simple. If it is run via the DOS auto-restart facility, AUTOKEY supplies a 
command line just as if the same one line were typed at the system console. If AUTOKEY is 
run from the system console (or likewise from an active CHAIN), it simply displays the 
command line it is currently configured to supply and offers the user the option of changing 
that stored command line. 

The command line supplied to AUTOKEY could do anything specifiable in one command 
line to the DOS; DATASHARE could be brought up, a SORT invoked, a user's own special 
restart program started or even a CHAIN begun. AUTOKEY, when used with AUTO, MANUAL, 
and CHAIN can therefore provide a very powerful facility. 

3.5 Detailed Use of AUTOKEY. 

To specify a command line to be used during automatic system restart, simply type: 
AUTOKEY 

at the system console. AUTOKEY will display a signon message and display the current 
autokey line if there is one. It then asks if this line is to be changed If 'N' is answered, 
AUTOKEY simply returns to the DOS and the familiar DOS 'READY' message is displayed. If 
'Y' is answered, AUTOKEY requests the new command line to be configured and then returns 
to the DOS and 'READY'. 

Alternately, if the user wishes to simply specify a new command line to be configured 
regardless of the current setting of that command line, he can merely place the new command 

line aiici 11 ic /-»ij I v-frst-T uuiiimciiiu iiidii iiivuKca me rtu i v^rxc: i uuiiiiiici'iu. 

An example or two are in order. First, a simple one. Assume that XYZ Company has 
several of their sales offices on-line to their home office DATASHARE system, which is running 
completely unattended. Lightning strikes a powerline outside of XYZ Company's home office, 
and power is cut off for 15 seconds. As soon as power is restored, their Datapoint 5500 
computer re-boots its DOS (since the right-hand tab on the boot tape has been punched out) 
and warmstarts the DATASHARE system. One command sequence to accomplish this would 
look like the following: 

AUTOKEY 

DOS AUTOKEY VERSION n.n 

NO AUTOKEY LINE CONFIGURED. 

CHANGE THE AUTOKEY LINE? Y 
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ENTER NEW AUTOKEY LINE: 

DS3 

READY 

AUTO AUTOKEY/CMO 

AUTO NOW SET TO AUTOKEY/CMD (nnn) 

READY 

An alternate form of the above would be the following: 

AUTOKEY DS3 

DOS AUTOKEY VERSION n.n 

NO AUTOKEY LINE CONFIGURED. 

ENTER NEW AUTOKEY LINE: 

DS3 <— (this is supplied automatically) 

READY 

AUTO AUTOKEY/CMD 

AUTO NOW SET TO AUTOKEY/CMD (nnn) 

READY 

Once a program has been set for auto-execution, the only way one can bypass this is to 
hold down the KEYBOARD key while the DOS is booting up. This will cause the program set 
to be automatically executed to not be invoked, and the normal command interpreter is 
entered. The user then can use the MANUAL command to clear the auto-execution option. 

3.6 A More Complicated Example. 

The following example uses many of the features of other facilities in the Datapoint 
system besides simply AUTOKEY. Explaining all of these in detail is beyond the scope of this 
section. The intention here is just to demonstrate the sophistication possible using AUTOKEY 
in conjunction with the other facilities within the DOS. 

Let's assume that XYZ Company is running an eight-port Datashare system. Each of the 
company's seven sales offices around the country has a Datapoint lioo computer which is 
connected up to the home office Datashare system as a port. (The eighth port is used by the 
home offices secretary, Susie, to maintain scoring for her bridge club). During the day, each 
of the seven sales offices makes inquiries of the central inventory, price, and model code files 
through a system of Datashare programs, and another Datashare program lets them key orders 
•nto a file called 'ORDERSn' where n is their port number. At the end of each business day, 
XYZ Company wants to process these orders. First they put the seven files all into one large 
file, sort it, and use a Datashare program to make corresponding entries into the master order 
file. The master order file is then reformatted and the index reconstructed. The final step is 
to create a second copy of the master order file onto magnetic tape, which will then be saved 
for" backup purposes. 

Since the operation just described is fairly lengthly, one of the more clever programmers 
at XYZ Company decided to allow it to run unattended after everyone else has gone home. 
They even set up Susie's MASTER program so that it automatically takes down the Datashare 
system and starts up the end-of-day processing one-half hour after the company's Los Angeles 
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sales office (two time zones behind the Chicago mail office) closes for the afternoon. When 
the daily processing is completed, Datashare is brought back up again so that it will be up by 
the time the first people start arriving at the New York sales office the next morning, an hour 
before the Chicago m^in office opens. 

In the event of an unanticipated power failure, the system will recover and bring itself 
back up, resuming operations at the last checkpoint established by AUTOKEY. Notice that the 
system is also left in a state such that after the cham completes, Datashare will automatically 
restart in the event of any possible system failure. 

The following chain file accomplishes the preceding, assuming that subdirectory 
'SYSTEM' is used throughout the chain. The chain file could be modified easily to eliminate 
this assumption. However, the chain file can be made almost arbitrarily complicated; the 
point here is simply to show one of many possible techniques for handling unattended 
operations which wish to restart automatically in the case of some failure. Notice that the 
chain file might have to be modified depending on the particular version of DSCON an 
installation is using. 

// IFS SI 

//.FIRST SET UP FOR AUTO RESTART IF REQUIRED. 

AUTOKEY CHAIN 0VERNITE;S1 

AUTO AUTOKEY/Cf^D 

//. NEXT APPEND TOGETHER THE SEVEN DAILY FILES. 

SAPP SALES1,SALES2,SCRATCH 

SAPP SCRATCH,SALES3,SCRATCH 

SAPP SCRATCH,SALES4,SCRATCH 

SAPP SCRATCH,SALES5,SCRATCH 

SAPP SCRATCH,SALES6,SCRATCH 

SAPP SCRATCH,SALES7,SCRATCH 

//. NOW SCRATCH CONTAINS THE DAILY FILES. 

AUTOKEY CHAIN 0VERNITE;S2 

// XIF 

// IFS S1,S2 

//. PHASE TWO SORTS FILE 'SCRATCH' INTO 'ORDERDAY'. 

SORT SCRATCH,0RDERDAY;1-5 

//. NEXT CHECKPOINT HAVING BUILT 'ORDERDAY'. 

AUTOKEY CHAIN 0VERNITE;S3 

//XIF 

// IFS S1,S2,S3 

//. PHASE THREE PROCESSES THE FILE WITH A DS3 PROGRAM. 

DSCON 

Y 

N 

Y 

Y 

1 

DS3 PROCESS 

//. THE MASTER ORDER FILE 'ORDERMAS' NOW IS UPDATED. 
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AUTOKEY CHAIN 0VERNITES4 
/ XiF 

>' IFS S1,S2.S3,S4 

ppmPM!^'''^'' REFORMATS THE MASTER ORDER FILE. 
REFORMAT 0RDERMAS,SCRATCHDR2R 

mTOK^TrZ.'!^''r. '^ "" ^E^Of^MATTED COPY OF 'ORDERMAS' 
AUTOKEY CHAIN OVERNITE.SS 

// XIF 

// IFS S1,S2,S3,S4,S5 

cnlTtLT.^ ""^^"^ 'SCRATCH' BACK TO 'ORDERMAS' 
COPY SCRATCH:DR2,0RDERMAS 
//. ORDERMAS' IS NOW READY FOR INDEXING 
AUTOKEY CHAIN 0VERNITE;S6 

// XIF 

/ !FS S1,S2,S3,S4,S5,S6 

//. PHASE SIX RECREATES THE INDEX FOR 'ORDERMAS' 
INDEX 0RDERMAS;1-16 

/. THE INDEX HAS NOW BEEN REBUILT 
AUTOKEY CHAIN 0VERNITE;S7 
// XIF 

// IFS S1,S2,S3,S4,S5,S6,S7 

//. NOW bUMP MASTER FILE TO 9-TRACK MAGNETIC TAPE. 

TAPE ORDERMAS/TXT;l/E 

B 

O 

200X4 



// XIF 

NOW THE BACKUP COPY OF 'ORDERMAS' IS ON TAPE. 

Y 
Nj 

N 

8 

Y 

AUTOKEY DS3 

//. AND START UP DATASHARE FOR NEXT DAY 
DS3 

// XIF 

3.7 Special Considerations 

When building long chain files that allow for automatic restart, several perhaps obvious 
considerations must be made. Among these are that a file must not be changed in such a 
way that the change cannot be repeated if the previous checkpoint is actually used To 
accomplish this, frequently the file being updated must be copied out to a scratch file, and the 
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scratch file then updated. Following the completion of the update is wnen another checkpoint 
would be taken: following that the next phase would copy the updated file back over the 
original Note that a checkpoint (i.e. resetting the AUTOKEY command line) would have to be 
before the creation of the dummy copy to be updated; putting a checkpoint between the 
creation of the copy to update and the actual updating process could result in the updating of 
a partially updated copy. A little thought when choosing places to update the AUTOKEY 
command line is called for to ensure that the chain may be resumed from any of them without 
incorrect results. 

3.8 AUTOKEY and DATASHARE. 

Some users who make frequent use of the Datashare ROLLOUT feature will notice that 
AUTO-ing AUTOKEY with the AUTOKEY command line set to DS3BACK will mean that 
whenever any port rolls out to any program or chain of programs, Datashare is automatically 
brought back up when that program or chain of programs finishes, regardless of whether or 
not DSBACK was included at the end of the port's chain file. 
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PART 111 



SYSTEM COMMANDS 



SECTION 4. BACKUP COMMAND 



4.1 INTRODUCTION 

BACKUP is a program for making disk copies of DOS disks. The user can make either 
an exact mirror image copy of the Input disk or can select reorganization which will group 
flies by extension and file name, remove unnecessary segmentation and allow deletion of 
unnecessary files. Reorganization also allows copying of DOS disks onto disks with locked out 
cylinders that differ from those on the input disk. Some special considerations apply for 
specific disk configurations; these considerations, if any, are discussed in the System manual 
for the specific DOS being used. 

4.2 PROGRAM INITIALIZATION 

Program execution is initiated by the operator typing the following command: 

BACKUP < input drive >,< output drive > 

Input drive, and output drive are specified as :DRn. The drive selected as the INPUT 
DRIVE MUST BE WRITE PROTECTED; that is, it must be in 'read only' mode or have its 
'protect' light on for 9370 and 9350 series drives respectively. The requirement for the input 
drive to be write protected is absent on the 9380 series flexible diskettes. The program will 
respond by displaying the message: 

DRIVE n SCRATCH? 

If the disk on drive n is scratch (note that the operation deals with logical drives), type 
'Y' and press the enter key. Any other reply will cause the program to return to DOS. If you 
do reply 'Y', the prograrti will display the message: 

ARE YOU SURE? 

If you are absolutely sure that you want to write over the output disk, type 'Y' again and 
press the enter key. Any other reply will cause the program to return to DOS. If the output 
(logical) disk has not been DOSGENed or the DOS file structure on it has been damaged, the 
message: 

DOSGEN YOUR DISK FIRST 

will appear and control returns to DOS. If the output (logical) disk has been DOSGENed and 
seems in reasonable shape, the following message is displayed: 

FILE REORGANIZATION? 

Note that the option to reorganize during the copy Is mandatory if the output disk has 



SECTION 4. BACKUP COMMAND 4-1 



any bad cylinders on it locked out. If this is the case, the 'FILE REORGANIZATION?' question 
IS bypassed completely and the reorganization option is assumed. 

If you wish to reorganize the files being transferred to the output disk, type 'Y' and 
press the enter key. If you have replied 'Y', see section 4.4. for instructions regarding 
reorganizing files. 

If you do not wish to reorganize your files and desire a mirror image copy of your input 
disk, type 'N' and press the enter key. 'Y' and 'N' are the only replies that will be accepted! 



4.3 MIRROR IMAGE COPY 

If you have typed 'N' in response to the file reorganization question, the program will 
ask the question: 

DO YOU WANT TO COPY UNALLOCATED CLUSTERS? 

Type 'Y' and press the enter key if you want all data on the disk' copied regardless of 
whether or not it is in an area allocated by DOS. This option is preferred in cases where you 
suspect that your DOS files may be partially destroyed or the output disk has never been fully 
initialized with data. 

Type 'N' and press the enter key if you wish to copy your disk as quickly as possible 
without copying unused areas of the input disk. 'Y' and 'N' are the only replies allowed! 

4.4 REORGANIZING FILES 

4.4.1 COPYING DOS TO OUTPUT DISK 

Various program status messages will appear during the copying of DOS. 

4.4.2 COPYING UNNAMED FILES 

If any files on the input disk have been allocated by Physical File Number (PFN) and do 
not have a name in the system directory, they will be copied during the sort phase using the 
same PFN. If unnamed files exist, the following message will be displayed temporarily 
overlaying the SORTING DIRECTORY NAMES message: 

COPYING PFN (nnn) 

4.4.3 DELETING NAMED FILES 

When all directory names have been sorted into file extension followed by file name 
sequence and all unnamed files have been copied, the following question will be displayed: 

DELETE ANY FILES DURING REORGANIZATION? 

Type 'N' and press the enter key if all files are to be copied. Type 'Y' and press the 
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enter key if you wish to delete any files. If vou reply 'v a r-essaae -^-^kin-. ..hi.h - 

NOT to be copied will annpar tho .^ " "^^^^age asking which rues are 

for you to choose fmm T J '""^^^ ^'" ^^ ^'"^^ ^^ ^ "^^^^^^^ "^^ °f f*'es 

names o^^inHi!?H T' '''^ *^^ "'"^'^^ °^ '^"^^ °^ '^^^^^^^ ("" °^ nn-nn) found next to 
elete a of h.f' '^'T ^^ ''^''^^ ^^P^ 'ALL' and press the enter key if wish to 
len a d' , eV 1^^^^ . l'" "'' '''''''' ^" deletion will be erased from the list. 

adrnc::o"rne:rr:f rn:::r"^ ^^^^ ^ '-' ^^^^ '-'^^^ --^ ^^^ -- -^ - 

namecT^l;:: phas^ ""' '"'' '"' '^^" ^^^"^'"^^' ''' ^^^^^^ -" ^^^^^ ^° ^he copy 
4.4.4 COPYING NAMED FILES 

n«mp !«^' '"*'' x!!"^' '" *^® '^'*^"' ^"'^'*°''y ^""^ ^°P'^^ '" alphameric file extension, file 
dTtaZZT^- !• "'^' °' """' "" '■' "'^P'^y^^ ^^ '* '^ ^°P*^^- P^^g^^^^ -bitten in 

rlosP tn 1 ^'^ ' ^^"^ ^^ ^" ^^'^"^^ *° *^^ ""'Q'* °f '^^ f"^ "^^^- AM files are written as 

Close together as possible with an absolute minimum of segmentation. 

4.5 USE OF KEYBOARD AND DISPLAY KEYS 

The keyboard and display keys are active anytime messages are being displayed 

th!Tr^ i^! '^'"'"^^ ^^^ ""'" ^°'^ *^^ ^"^^^"* ^'^P'^y ^"^" ^h« key is released. Depressing 
the keyboard key will cause the program to terminate and return to DOS. 

4.6 ERROR MESSAGES 

During the execution of BACKUP the following error messages may appear: 

***PLEASE PROTECT YOUR INPUT DISK ♦** 

Action: Write-disable the input drive. 

INVALID DRIVE SPECIFICATION! 

Action: Retype the BACKUP command with correct < input-drive > and 
< output-drive > specification. (See section 3.) 

ILLEGAL OUTPUT DRIVE! 

^f^'!'-^'''P''^''^'''''^>^^^ < output-drive > have been specified as the same drive! Retype 
BAGKUP command with correct specification. 

BAD CLUSTER ALLOC TABLE! 

Action: A bad Cluster Allocation Table has been detected on the input disk. The Cluster 
Allocation Table may be able to be fixed using the REPAIR command. 

CYLINDER OF BACKUP DISK IS UNUSABLE! 
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Action: Your scratch disk cannot be used for a system disk due to surface defects in cylinder 
0. Use another output disk and start over. 

SYSTEMn /SYS IS MISSING! 

Action: Your DOS disk cannot be reorganized due to a missing system file. Catalog the 
missing system file on your input disk and start over. 

PARITY- :DRn, address 

Action: An irrecoverable parity error has been detected on drive n during the BACKUP 
operation. The address is shown for each error. If drive n is your output disk, DOSGEN must 
be rerun to lockout the bad addresses or use a different scratch disk for mirror image copy. If 
drive n is your input disk, new parity will be computed and the record will be copied. Note the 
error address and check for errors when copy is complete. 

4.7 REORGANIZING FILES FOR FASTER PROCESSING 

After a DOS disk has been used for awhile, the file structure becomes fragmented and 
related files become scattered. The more the disk is used the more total system performance is 
degraded due to increased disk access time. System degradation is especially noticeable when 
DATASHARE is being used. File reorganization using the BACKUP program is one way to 
clean up DOS disks and improve their efficiency. 

BACKUP reorganization improves system efficiency by making the following changes: 

. File segments are consolidated 

. Files are packed more closely together 

. Related files are clustered together 

. Unused trash files are removed (optionally) 

Files are rewritten reducing marginal parity errors 



Care should be exercised in naming files so that related files have the same file 
extensions and similar file names that will allow them to be grouped when the system 
directory is sorted. 
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BLOKEDIT - BLOCK EDIT program. 
5.1 INTRODUCTION 

The BLOKEDIT program is a DOS text file manipulation program. The program copies 
Imes of text from any DOS text file(s) to create a new text fife. 

The BLOKEDIT program is useful for such things as: 

New program source file generation by copying routines from 
existing program source files; 

Existing program source file re-arranging by copying the lines of 
source-code into a new sequence (into a new source file); 

Re-arranging lines or paragraphs of a SCRIBE file into a new file. 

In this USER'S GUIDE, the following applies: 

Text file means a DOS EDIT-compatible file. 

L//?e means one line of a text file as displayed by the DOS EDIT 
program. 

The BLOKEDIT program deals only with text files. For any given application 
there will be one text file called the COMMAND FILE which will hold the controlling 
commands for BLOKEDIT, there will be one or more text files called SOURCE FILES 
from which lines of text will be copied, and there will be one text file called the 
NEW FILE which will be the desired end result for the application. 

5.2 FILE DESCRIPTIONS 

5.2.1 COMMAND FILE: 

The COMMAND FILE Is the controlling factor in BLOKEDIT execution. The 
COMMAND FILE specifies which SOURCE FILES will be used and which lines of text 
will be copied from them. A COMMAND FILE must be created by the DOS EDIT 
program before BLOKEDIT can be used. 

There are three kinds of lines that are meaningful in a COMMAND FILE; 
COMMENT lines, COMMAND lines, and QUOTED lines 
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A COMMENT line is a line which has a first character of period. 
This is an example of COMMENT LINES: 

. THESE THREE LINES ARE COMMENT LINES. 



As in program source files, a comment line may have explanatory notes or 
nothing at all following the period. 

A COMMAND LINE is a line which has a SOURCE FILE NAME and/or source 
file LINE NUMBERS, or begins with a double quote symbol ('). 

This is an example of COMMAND LINES: 

FILENAME/EXT:DRO NAME THE SOURCE FILE 

1-100 COPY LINES 1 THRU 100 

350-377 COPY LINES 350 THRU 377 

A COMMAND LINE must have a first character of an upper-case alphabetic 
character, or a digit, or a double quote symbol. 

A COMMAND LINE that begins with an upper-case alphabetic character 
indicates that a new SOURCE FILE is being named. A new source file can be named 
only by putting the name of the file at the very beginning of the COMMAND LINE. 
Optionally, the extension and/or drive number for the file may be included with the 
SOURCE FILE name. 

A COMMAND LINE that begins with a digit indicates that the COMMAND LINE 
will have one or more numbers, which are the numbers of the lines tc be copied from 
the SOURCE FILE into the NEW FILE. 

A COMMAND LINE that begins with a double quote symbol indicates the 

^v^^ri •> ,■• .>^, «^i luii ivj wi >.Mw^y I i_k^ u.ii^i_o. I I ifc <_»iiiy II iiwi iiiainjii I uocu uy OL.\jf\c.ui \ in a 

COMMAND LINE that begins with a (') Is the (') itself, therefore the rest of the line 
can be used for comments. 

A QUOTED LINE is a line between a pair of COMMAND LINES which begin 
with a double quote symbol. 

This is an example of QUOTED LINES: 

' THIS IS THE BEGINNING OF QUOTED LINES COMMAND LINE. 

INCMNT HL COUNT POINT TO COUNTER 

LAM LOAD TO 'A' REGISTER 

AD 1 INCREMENT BY 1 

LMA RESTORE TO MEMORY 

' THIS IS THE ENDING OF QUOTED LINES COMMAND LINE. 
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There may be more than one QUOTED LINE between the COMMAND ' 'NES -h-t 

the^NEW FLE "ouo^Jn^"' "'" "^ '°'''' ^^'^"^ '--*''« COMMAND f'e 
1 texMn a NEW f7f^ LINES enable the BLOKEDIT user to Include original lines 
01 text in a NEW FILE along with lines copied from SOURCE FILES. 

5.2.2 SOURCE FILE: 

cooled'' fo^^RcVlti" ' °°^ EDIT-compatable text file from which lines will be 
uupiea buuKOE FILES are named in the COMMAND FILE for a BLOKEDIT 

m"' e 'cOMMAMn' l,!'^'' !° '' '""'^^ "°"' "'^ ^""'^'^^ "^^ *'" ^'«° ^e specified 
n the COMMAND FILE. It will be useful to have a listing of a SOURCE FILE with 

u^^.Z^nl'Lf^ ^'""""^^ "'' ''^ "-'^^ command, when creating the COMMAND FILE 
lor a bLOKEDIT application. 

5.2.3 NEW FILE: 

A NEW FILE is a DOS EDIT-compatable text file produced by the BLOKEDIT 
command. The NEW FILE is named at BLOKEDIT execution time by the second file 
specification keyed to the DOS keyboard facility {see below). 

5.3 USING BLOKEDIT. 

^^^^'^ the BLOKEDIT command can be used the user must create a COMMAND 

m n^cn.t^^'"''^^'^ ^^""^^ ^"^ '" *^® BLOKEDIT APPLICATION EXAMPLE. When the 
BLOKEDIT command is to be executed, the operator must key: 

BLOKEDIT <filespec>.<fllespec> 

to the DOS keyboard facility. The first file specification refers to a COMMAND FILE 
and the second file specification names the NEW FILE. If no extension is supplied 
with the first file specification, TXT (text) is assumed. If no extension is supplied with 
he second file specification, the extension given or assumed for the first file is used. 
If no drive is given for the first file, all drives are searched. If no drive is given for 
the second file, the drive given or assumed for the first file is used. The NEW FILE 
name must not exist on any drive on line. 

5.4 BLOKEDIT APPLICATION EXAMPLE: 

The following example of a BLOKEDIT application demonstrates the use of the 
functions of BLOKEDIT. 

The example is of the creation of a new assembly language program source file 
from both new source code lines and source code lines copied from (hypothetical) 
existing subroutine packages. 

The program to be created is ADDER. ADDER will accept two numbers (each a 
maximum of four digits) from the keyboard and calculate and display the sum of the 
numbers The normal DOS KEYIN$ and DSPLY$ routines are used for Input/Output 
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the main loop of the program is created in the BLOKEDIT COMMAND FILE ADDERX, 
and the formatting and arithmetic subroutines are copied from the (hypothetical) 
existing subroutine packages CONVERT and ASMD (Add, Subtract, Multiply, and 
Divide). 

Subsection 5.5 shows the COMMAND FILE ADDERX as printed by the LIST 
command. 

Lines 1 thru 3 of the COMMAND FILE are COMMENT LINES. They inform the 
reader of the purpose of the file; in this case to create the program source file for 
the ADDER program. 

Line 4 of the COMMAND FILE is a COMMAND LINE which has a first character 
of double quote symbol ('). Line 4 indicates that lines following it are to be copied 
to the NEW FILE, until but not including the next line that begins with a double quote 
(') symbol. Since the only information used by BLOKEDIT in a COMMAND LINE that 
begins with (') is the (') itself, the rest of the line can be used for cornments. The 
comment in line 4 notes that the main loop of the NEW FILE source code is 
contained within the (') lines. 

Lines 5 thru 98 of the COMMAND FILE are QUOTED LINES. These lines will be 
copied directly into the NEW FILE. In this example, the QUOTED LINES are standard 
assembler language source code lines. If the COMMAND FILE is created with the 
EDIT command in the assembler mode, then the tab stops will be conveniently set for 
the creation of assembly code lines. 

Line 99 of the COMMAND FILE is a COMMAND LINE which begins with a ('), 
and indicates that the QUOTED LINES are ended. 

Line 100 of the COMMAND FILE is a COMMAND LINE and indicates to 
BLOKEDIT that a new SOURCE FILE is being named. That is, line 100 indicates to 
BLOKEDIT that it is to prepare to copy lines from the file named 'CONVERT' into the 
NEW FILE. Since no extension is specified, the extension TXT is assumed. 
Since no drive is specified, all drives will be searched for a file name CONVERT/TXT. 
.-.GXe that after at least one blank character in a COMMAND LINE comments may be 
included. 

Subsection 5.6 shows the SOURCE FILE CONVERT lines to be copied as 
printed by the LIST command. For the purpose of example, the hypothetical file 
CONVERT is a subroutine package of string numeric conversion routines. 

The lines of source code for the subroutines MOVEN (move a numeric field), 
ZSUPRS (zero suppress), BCD (convert to Binary Coded Decimal), and ASCII (convert 
to American Standard Code for Information Interchange) are shown. These are the 
lines of source code to be copied and used by the ADDER program. 

Lines 101 and 102 of the COMMAND FILE are COMMAND LINES and indicate 
to BLOKEDIT that it is to copy lines 191 thru 259, 311 thru 325, 407 thru 420. and 472 
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thru 485 inclusive from the currently named SOURCE FILE (which is now CONVERT) 
into the NEW FILE. v^^>ivc:n.; 

Line 103 of the COMMAND FILE is a COMMAND LINE which indicates that a 
new SOURCE FILE is being named. This time the SOURCE FILE is 'ASMD'. The 
extension TXT will be assumed since no extension is specified, and all drives will be 
searched since no drive is specified. 

Subsection 5.7 shows the SOURCE FILE ASMD lines to be copied as printed by 
the LIST command. For the purpose of example, the hypothetical file ASMD is a 
subroutine package of string numeric routines Add, Subtract, Multiply, and Divide. 

The lines of source code for the subroutine ADD (add two BCD numbers) are 
shown. These are the lines of source code to be copied and used by the ADDER 
program. 

Line 104 of the COMMAND FILE is a COMMAND LINE and indicates to 
BLOKEDIT that it is to copy lines 101 thru 137 inclusive from the currently named 
SOURCE FILE (which is now ASMD) into the NEW FILE. 

Line 105 of the COMMAND FILE is a COMMAND LINE which begins with a ('), 
indicating that QUOTED LINES follow. 

Lines 106 and 107 of the COMMAND FILE are QUOTED LINES, and will be 
copied directly to the NEW FILE. 

Line 108, the last line of this COMMAND FILE, \s a COMMAND LINE which 
begins with ('), indicating the end of QUOTED LINES. Note that no special ending 
line is required in a COMMAND FILE, the normal DOS EDIT-generated End-Of-File 
mark terminates the file. 

When the COMMAND FILE has been constructed, BLOKEDIT can be executed. 
To cause BLOKEDIT to generate the NEW FILE 'ADDER' in this example, the operator 
would key: 

BLOKEDIT ADDERX,ADDEB 

to the DOS keyboard facility. This calls up the BLOKEDIT command, and names the 
file ADDERX as the COMMAND FILE and specifies that the NEW FILE will be named 
ADDER. 

Subsection 5.8 is an assembled listing of the NEW FILE ADDER source code 
created by BLOKEDIT. 



SECTION 5. BLOKEDIT COMMAND 5-5 



5.5 'ADDERX' command file for BLOKEDIT creation of 'ADDER' program. 

The following lines make up the COMMAND FILE used by the BLOKEDIT 
command to create the NEW FILE source code for the program 'ADDER'. The lines 
are are shown as listed by the 'LIST' command. 



1. 



THIS IS THE COMMAND FILE TO CREATE THE PROGRAM SOURCE 



FILE 

2. 

3. 

4. 

THE 

5. 

6. 

7. 

AND 

8. 

9. 
10. 
11. 
12. 
13. 
14. 
15. 
16. 
17. 
18. 
19. 
20. 
21. 
22. 
23. 
24. 
25. 
26. 
27. 
28. 
29. 
30. 
31, 
32. 
33. 
34. 



FOR THE 'ADDER' PROGRAM. 



QUOTES 

DOS 2.1 



ADDER 1.1 



THE MAIN LOOP WILL BE IN 
JUNE 15, 1973 PAD 



THIS PROGRAM ACCEPTS TWO NUMBERS FROM THE KEYBOARD 

PRODUCES THEl,R SUM. 

THE NUMBERS MAY BE A MAXIMUM OF FOUR DIGITS LONG. 



DOS EQU'S: 

BOOTS ECU 01000 

DSPLYS EQU 01162 

KEYIN$ EQU 01157 

INCHLS EQU 01011 

. DATA STORAGE: 

INPUT SK 10 



F1 
F2 



DC 0,0,0,0 
DC 0,0,0,0 
DC 3 



UP TO TEN CHARACTERS 

FIRST NUMERIC FIELD 
SECOND NUMERIC FIELD 
STOP THE DISPLAY 



SCREEN MESSAGES: 



Ml 



M2 



DC 01 1,0,01 3.0,021, A ODER 

DC Oil, 0,01 3,2,FACTOR 1:' 

DC 011,0,013.3,'FACTOR 2:' 

DC 011,10,013,4,' . ' 

DC 011,5,013,5, 'SUM:',3 

DC 011,20,013,5,'OVERFLOW ,3 



PROGRAM 



5-6 



PART III SYSTEM COMMANDS 



35. 

37. 

38. 

39. 

40. 

41. 

42. 

43. 

44. 

45. 

46. 

47. 

48. 

49. 

50. 

OK 

51. 

52. 

53. 

54. 

55. 

56. 

57. 

58. 

59. 

60. 

61. 

62. 

63. 

64. 

65. 

66. 

67. 

68. 

69. 

70. 

71. 

72. 

73. 

74. 

75. 

MESSAGE 

76. 

77. 

78. 

79. 

80. 

81. 



M3 



START 



GETF1 



DC 011,1 0,01 3,2,022,01 3,3,022,01 3,4,022,01 3,5,022,3 36. 



GETF2 



ADDIT 



HL 


Ml 


CALL DSPLY$ 


LC 


5- 


LD 


10 


LE 


2 


HL 


INPUT 


CALL 


. KEYIN$ 


LC 


4 


DE 


INPUT 


HL 


F1 


CALL 


MOVEN 


JFC 


GETF2 


EX 


BEEP 


JMP 


GETF1 


LC 


5 


LD 


10 


LE 


3 


HL 


INPUT 


CALL 


KEVINS 


LC 


4 


DC 


INPUT 


HL 


F2 


CALL 


MOVEN 


JFC 


ADDIT 


EX 


BEEP 


JMP 


GETF2 


LC 


4 


HL 


F1 


CALL 


BCD 


LC 


4 


HL 


F2 


CALL 


BCD 


CALL 


ADD 


HL 


M2 



CTC DSPLY$ 

LC 4 

HL F2 

CALL ASCII 

LC 3 



DISPLAY THE SIGN-ON 
GET THE FIRST NUMBER 



EDIT AND MOVE TO FIELD 1 



GET NEXT NUMBER IF FIRST 

ELSE MAKE A NOISE 
TRY AGAIN 

GET THE SECOND NUMBER 



EDIT AND MOVE IT TO F2 



COMPUTE SUM IF OK 
ELSE MAKE A NOISE 
TRY AGAIN 

CONVERT F1 TO BCD 



CONVERT F2 TO BCD 

ADD F1 TO F2 GIVING F2 
DISPLAY THE OVERFLOW 

IF CARRY FLAG SET 

CONVERT F2 TO ASCII 

SUPPRESS LEADING ZEROS 
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82. 


HL 


F2 


83. 


CALL 


ZSUPRS 


84. 






85. 


LD 


10 


86. 


LE 


5 


87. 


HL 


F2 


88. 


CALL 


DSPLYS 


89. 






90. 


LC 


2 


91. 


HL 


INPUT 


92. 


CALL 


KEYIN$ 


93. 


MLA 


INPUT 


94. 


CP 


'X' 


95. 


JTZ 


BOOTS 


96. 


HL 


M3 


97. 


CALL 


DSPLYS 


98. 


JMP 


GETF1 


99. 


' 




100. 


CONVERT 




SOURCE 


FILE 




101. 


191-259,311-325,407-420 


102. 


472-485 




103. 


ASMD 




FILE 






104. 


101-137 




105. 


' 




STATEMENT 




106. 






107. 


END 


START 


108. 


' 





LEAVE AT LEAST ONE DIGIT 



DISPLAY THE SUM 



WAIT FOR OPERATOR READY 

QUIT IF XIT COMMAND 

CLEAR THE SCREEN 

DO IT AGAIN 

USE 'CONVERT/TXT' AS 

COPY THESE l;NES 

NOW USE 'ASMD' AS SOURCE 

COPY THESE LINES 
NOW PUT THE 'END' 



5.6 'CONVERT' subroutine package subroutines. 

The following excerpts from the (hypothetical) subroutine package 'CONVERT' 
show the source code lines to be copied into the 'ADDER' program. The lines are 
shown as listed by the 'LIST' program. 



191. 
192. 
193. 
194. 
195. 



MOVE A FIELD OF CHARACTERS TERMINATED BY A 015 INTO 
AN ASCII FIELD AND EDIT THE SOURCE FIELD TO BE SURE 
IT IS ONLY LEADING BLANKS OR DIGITS AND IS NOT LONGER 
THAN THE ASCII FIELD. 
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196. 


C 


= NUMBER OF C 


197. 


DE 


= BEGINNING Al 


198. 


HL 


= BEGINNING 01 


199. 








200. 


MOVEN 


PUSH 




ADDRESS 








201. 








202. 




LHD 




LENGTH 








203. 




LLE 




204. 








BLANKS 








205. 


ML00P1 


LAM 




206. 




OP 


' ' 


207. 




JFZ 


ML00P2 


208. 




LAC 




COUNTER 








209. 




SU 


1 


210. 




LCA 




211. 




JTC 


M ERROR 


LARGE 








212. 




GALL 


INCHL$ 


POINTER 








213. 




JMP 


ML00P1 


214. 








FIELD 








215. 


ML00P2 


LAM 




216. 




CP 


015 


217. 




JTZ 


M LOOPS 


218. 




CP 


'0' 


219. 




JTC 


MERROR 


220. 




CP 


'9'+1 


221. 




JFC 


MERROR 


222. 




CALL 


INCHL$ 


223. 




LAC 




224. 




SU 


1 


225. 




LCA 




226. 




JFC 


MLOOP2 


227. 




JMP 


MERROR 


LARGE 








228. 








229. 


ML00P3 


POP 




230. 


ML00P4 


LAC 




TO PAD 








231 . 




SU 


1 


232. 




LCA 




233. 




JTC 


ML00P5 


234. 




LA 


'0' 



FIELD. 

SAVE THE BEGINNING 

OF THE ASCII FIELD 

EDIT AND DETERMINE THE 

OF THE FIRST FIELD 
SCAN OFF THE LEADING 

GET A CHARACTER 
LEADING BLANK IS OK 
END OF BLANKS 
DECREMENT THE LENGTH 



CATCH SOURCE FIELD TOO 

BUMP THE SOURCE FIELD 

LOOP 

SCAN TO END OF SOURCE 

GET A CHARACTER 
CATCH END OF STRING 

ELSE MUST BE '0' THRU '9' 



BUMP MEMORY POINTER 
DECREMENT THE COUNTER 



LOOP IF MORE TO GO 
CATCH SOURCE FIELD TOO 

PAD ASCII FIELD ZEROS 
RESTORE ASCII POINTER 
C REGISTER IS HOW MANY 



DO CONVERT IF END OF PAD 
PAD ASCII ZERO 
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235. 




LMA 




236. 




CALL 


INCHL$ 


237. 




JMP 


MLOOP4 


238. 








239. 


ML00P5 


PUSH 




240. 




LHD 




241. 




LLE 




242. 




LBM 




243. 




CALL 


INCHL$ 


244. 




LDH 




245. 




LEL 




246. 




POP 




247. 




LAB 




248. 




CP 


015 


STRING 








249. 




RTZ 




250. 




CP 


• ' 


251. 


, 


JFZ 


M LOOPS 


252. 




LA 


'0' 


253. 


ML00P6 


LMA 




254. 




CALL 


iNCHL$ 


255. 




JMP 


ML00P5 


256. 








257. 


MERROR 


LA 


1 


258. 




SRC 




259. 




RET 





BUMP MEMORY POINTER 
LOOP 

SAVE ASCII POINTER 
POINT TO SOURCE FIELD 

GET CHARACTER 
BUMP SOURCE POINTER 



POINT TO ASCII 

CATCH END OF SOURCE 

QUIT IF THERE 

CONVERT BLANK TO ZERO 

PUT DIGIT IN ASCII FIELD 
BUMP ASCII POINTER 
LOOP 

EXIT WITH ERROR FLAG 



311. 

312. 

313. 

314. 

315. 

CHAR. 

316. 

317. 

318. 

319. 

BLANK 

320. 

321. 

322. 

323. 

324. 

325. 



SUPPRESS LEADING ZEROS IN AN ASCII FIELD. 
C = NUMBER OF ZEROS TO SUPPRESS 
HL = FIRST DIGIT IN FIELD 



ZSUPRS LB 

ZSLOOP LAM 
CP 
RFZ 
LMB 



'0' 



CALL INCHL$ 

LAC 

SU 1 

LCA 

JFZ ZSLOOP 

RET 



INITIALIZE THE SUPRESSION 

GET A DIGIT 

SEE IF IT'S ZERO 

QUIT IF NOT 

ELSE OVERSTORE WITH 

BUMP THE MEMORY POINTER 
DECREMENT THE COUNTER 



LOOP IF MORE TO 
ELSE QUIT 



;o 
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407. 


. CONVERT A 1 


408. 




C 


= N 


409. 




HL 


= F 


410. 








411. 


BCD 




LB 


412. 


BCD! 


-UP 


LAM 


413. 






XRB 


414. 






LMA 


415. 






CALL 


416. 






LAC 


417. 






SU 


418. 






LCA 


419. 






JFZ 


420. 






RET 



-D OF ASCII DIGITS TO BCD. 
= NUMBER OF DIGITS TO CONVERT 
FIRST DIGIT ADDRESS 



'0' 



INCHLS 



BCDLUP 



INITIALIZE THE XOR BITS 
GET A DIGIT 
STRIP THE ASCII BITS 
RESTORE DIGIT TO MEMORY 
POINT TO NEXT DIGIT 
DECREMENT TO COUNTER 



LOOP IF MORE TO GO 
ELSE DONE 



472. 

473. 

474. 

475. 

476. 

477. 

478. 

479. 

480. 

481. 

482. 

483. 

484. 

485. 



CONVERT A FIELD OF BCD DIGITS TO ASCII. 
C - NUMBER OF DIGITS TO CONVERT 
HL = FIRST DIGIT ADDRESS 



ASCII LB 

ASCLUP LAM 



'0' 



ORB 

LMA 

CALL INCHL$ 

LAC 

SU 

LCA 

JFZ 

RET 



1 



ASCLUP 



INITIALIZE THE OR BITS 
GET A DIGIT 
PUT IN THE ASCII BITS 
RESTORE TO MEMORY 
POINT TO NEXT DIGIT 
DECREMENT THE COUNTER 



LOOP IF MORE TO GO 
ELSE DONE 



5.7 ASMD' subroutine package 'ADD' subroutine. 

The following excerpt from the (hypothetical) subroutine package 'ASMD' shows 
the source code lines to be copied into the 'ADDER' program. The lines are shown 
as listed by the 'LIST' command. 



101 
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102. . ADD TWO FOUR-DIGIT BCD NUMBERS TOGETHER, PUTTING THE 

103. . RESULT IN THE SECOND NUMBER. 

104. THE FIRST NUMBER IS IN F1 (FIELD 1). 

105. THE SECOND NUMBER IS IN F2 (FIELD 2). 

106. THE CARRY FLAG WILL BE ON IF OVERFLOW. 
107. 

108. ADD LC -10 INITIALIZE THE CARRY BIAS 

109. ADD4 MLB F1+3 WORK FROM RIGHT TO LEFT 

110. MLA F2+3 

111. ADB 

112. LMA 

113. ADC 

114. JFC ADD3 

115. LMA 

116. ADD3 MLB F1+2 

117. MLA F2+2 

118. ACB 

119. LMA 

120. ADC 

121. JFC ADD2 

122. LMA 

123. ADD2 MLB F1 + 1 

124. MLA F2+1 

125. ACB 

126. LMA 

127. ADC 

128. JFC ADD1 

129. LMA 

130. ADD1 MLB F1+0 

131. MLA F2+0 

132. ACB 

133. LMA 

134. ADC 

135. RFC EXIT CARRY FALSE IF NO 
OVERFLOW 

136. LMA 

137. RET EXIT CARRY TRUE \f 
OVERFLOW 
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5.8 Assembly listing of ADDER 



5.9 BLOKEDIT execution-time messages. 



This appendix describes the operator messages that BLOKEDIT may display on 
the CRT screen during execution. Some of the messages are monitor messages to 
keep the operator informed of the progress of the program, while other messages are 
error messages. 



BLOCK EDIT 

This message is the BLOKEDIT sign-on and is displayed when the COMMAND 
FILE name and the NEW FILE name keyed by the operator have been accepted and 
BLOKEDIT is ready to begin construction of the NEW FILE. 

PROCESSING COMMAND LINE .... CURRENT SOURCE FILE IS ..../...: DR. 

This message is the BLOKEDIT monitor message. This message is displayed while 
BLOKEDIT is writing lines of text to the NEW FILE. The monitor message displays 
the COMMAND FILE line number currently being processed and the name, extension, 
and drive number of the last named SOURCE FILE. 

If BLOKEDIT detects an error In the COMMAND FILE the monitor message is 
rolled up the screen one line, an appropriate error message is displayed, and the 
monitor message is re-displayed. In this way a screen-log of where errors in the 
COMMAND FILE occur is maintained. 

COMMAND AND NEW FILE NAMES REQUIRED 

This message is displayed if the operator did not name both a COMMAND FILE 
and a NEW FILE when the BLOKEDIT command was called. 

COMMAND FILE DRIVE INVALID 

This message is displayed if the operator specified for the COMMAND FILE a 
drive number that is invalid. 

NEW FILE DRIVE INVALID 

This message is displayed if the operator specified for the NEW FILE a drive 
number that is invalid. 

COMMAND AND NEW FILE NAMES MUST NOT BE IDENTICAL. 
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This message is displayed if the operator specified COMMAND FILE and NEW 
FILE names the same and the extension and the drives for the files were specified or 
assumed to be the same. 

If no extension is given for the first file (the COMMAND FILE) specification, TXT 
(text) IS assumed. If no extension is given with the second file (the NEW FILE) 
specification, the extension given or assumed for the first file is used. If no drive is 
given for the first file, all drives are searched. If no drive is given for the second 
file, the drive given or assumed for the first file is used. 

COMMAND FILE NOT FOUND. 

This message is displayed if the COMMAND FILE name was not found on the 
drive(s) specified or assumed. 

NAME IN USE. 

This message is displayed if the NEW FILE name was found on the drive(s) 
specified or assumed. BLOKEDIT will not write into an existing file. 

BAD FILE SPECIFICATION ? 

This message is displayed if the first character of a COMMAND FILE line other 
than a QUOTED LINE is an upper-case alpha character but a valid DOS file 
specification was not recognizeable. 

Here are some examples of valid DOS file specifications: 

FILENAME File name may have up to 8 characters. 

X Only one alpha character also legal. 

A123 Digits legal if after alpha character. 

NAME/TXT Extension specified after '/' symbol. 

NAME:DR2 Drive specified after ':' symbol. 

NAME/TXT:DR1 Extension and drive specified. 

Here are some examples of invalid DOS file specifications: 

FILENAMEONE Over 8 characters. 

2ABC First character not upper-case alpha. 

NAME*TXT Unrecognizeable delimiter. 

NAME:DV2 Invalid drive specification. 



SOURCE FILE NOT FOUND. 

This message is displayed if a SOURCE FILE was not listed in the DIRECTORY 
of the disk pack in the drive(s) specified or assumed. 
BAD LINE NUMBER SPECIFICATION ? 
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This message is displayed if a COMMAND FILE line other than a QUOTED LINE 
began with a digit but contained an unrecognlzeable line number specification. 

Here are some examples of valid line numbers: 

4 A single digit is legal. 

9999 A number may have up to four digits. 

100-364 Two numbers may be seperated by a '-'. 

34,55-78,100-147 Commas may separate numbers. 

Here are some examples of invalid line numbers: 

1A Only '-', ',', or space after a digit. 

12345 Number too large. 

17-34-77 Only two numbers seperated by '-'. 



LINE NUMBER ZERO IGNORED. 

This message is displayed if a line number of zero is specifed in a COMMAND 
FILE line. 

START LINE NO. >END LINE NO., IGNORED. 

This message is displayed if the first number of a line number pair is larger 
than the second number of the pair, as in: 235-176. 

BAD DATA IN SOURCE FILE LINE 



This message is displayed if BLOKEDIT discovers non-ASCII characters in a 
source file. The line number will be displayed following the message. 

SOURCE FILE WENT TO E.O.F.. 

This message is displayed if the SOURCE FILE from which lines were being 
copied ended before the specified lines were finished. 

TEXT TRANSFER DONE. 

NEW FILE'S LINE COUNT IS 

This message is displayed when all of the COMMAND FILE lines have been 
executed. The number of lines in the NEW FILE is displayed following the second 

line. 



SECTION 5. BLOKEDIT COMMAND 5-15 



PAGE i ADOEH/TXT 8 L K £ I T SAHPiE P>*OGRAM FEB«uA«V, 1975 

DOS ♦fsSfeKeLEW 5,1 6ft3 LABELS 

CONflOeNTlAl PWOPKIETAKV INPOKMATIO^J 

TmI3 item is The PWDPEFiTY OF OATAPUJWT C0RP0KATIUN» SAN ANTO^IO, TEXAS, AND CONTAINS COmFIuEnTIAL ANU 
TRADE SECRET INFORMATION, THIS ITEM HAY NOT BE TRANSFERRED FROM THE CUSTODY OR CONTROL OF DATAPOInT EXCEPT 
AS AUTMORIZeO 8Y QATaPOIKT AND THEN ONLY BY imaY OF LOAM FOR LIMITED PURPOSES, IT «UST NOT Bg REPROUUCED 
IN hHOte OR IN PART AND MUST BE RETURNED TO OATaPOINT UPON HEOUCST AND IN ALL EVE'^TS UPOn COMPLETION OF 
THE PURPOSE OF THE LOAN, 

NEITHER THIS ITEM NOR THE INFORMATION IT CONTAIN* MAY BE USED OR OISCLOSfO TO PERSONS NOT hAVInS A NEED 
FOR SUCH USE OR DISCLOSURE CONSISTENT WJTH THE PURPOSE OF THE LOAN, WITHOUT THE PRIOR WRITTEN CONSENT OF 
DATAPOINT, 



PAGE 



AOoe»</TXT 



L'ATAPUIMT COnFIOEnTIaL iKFOft-^ATlUN - StK PAGE 1 
riLUKtOlT SAHPue P*<OG«AH FEBKUAHY, 1975 



UNU&£!> UASfcLSI 



Al)U4 



PA&E 



ADO£f</TXT 



OATAPOINT CQNFIDENTIAI. iNfORf^ATION • 3t£ PAGE I 
BLOt^eOJT SAMPLE PKDGKAM PeSkUARY, 1975 



2. 

5. 

<. 

5. 

6. 

7, 

8. 

9. 
1?. 
11. 
12. 
13. 
l«. 
15, 
16. 
17. 
18, 
IS. 
29, 
21. 
22. 
23. 
24. 
25. 
26. 
27. 
26. 
29. 
30. 
31. 
32. 
33. 

34. 

35. 

36. 
37. 
38. 
39. 
4». 
41, 
42. 
43, 
44. 
45. 
4&. 
«7. 
48, 
09. 

5?. 
51. 
52. 
53, 
54, 



01000 
01102 
01157 
01011 



10000 

10000 
10004 

leeie 



I00ii 

10092 
10067 
10104 
10119 

10126 
10144 



10163 

10167 
10172 
10174 
10176 

10200 
10204 
10207 
10211 
1VS215 
lk9221 
10224 
1^227 
IW23H 

1^9233 
10235 
1*3237 
H^24l 
10249 



000 060 000 0iS0 
000 000 000 000 
003 



0U 000 013 0^0 021 

011 000 013 002 106 

011 000 k^l3 003 106 

011 §12 013 004 0S9 

011 009 013 009 123 

011 024 013 009 117 

011 012 013 002 022 



066 011 056 020 
106 1€2 002 
026 005 

036 012 

046 002 

066 000 096 020 

IM6 197 002 

026 004 

046 00«i 036 020 

066 000 056 020 

106 020 021 

100 233 020 

151 

104 172 ^20 

t^26 005 
036 012 
046 003 

nee 000 056 020 

106 197 e'H2 



DOS 2,1 



A D £ H 



US 



THIS PRQ6«AH ACCEPTS T«U numSCRS FROM THE k£YB0AH0 ANO 

PRODUCES THEIR SUM, 

THE NUMBERS MAY BE A mAXIhum OF FOUR DItlTS UONS, 

DOS EOU'Sl 

800TJ EQU >1000 

OSPUY* EQU l9ll62 

KEYIN* EQU 01197 

INCHLS EQU 01011 



, DATA STORAGE! 
INPUT 8K 



Fl 
P2 



DC 
DC 
DC 



0f0r0f0 

0»0»0f0 

3 



UP TO TEN CHARACTERS 

FIRST NUMERIC FIEUD 
SgCONO NUMERIC FIELD 
STOP THE DISPLAY 



SCREEN HESSASESf 



HI 


DC 




DC 




OC 




DC 




OC 


• 




N2 


OC 


»^3 


OC 



P R S R A H J ' 



START 



GETFl 



GETF2 



eUf0f0l3»0;02li <A ODER 
011,0,813,2, 'FACTOR il» 
011,0,013,9, 'FACTOR 2l« 
011, 10,019,4, *•»••«! 
011,9,013,9, 'SUM I S3 . 



011,20,013,5, 'OVEf^FLOM >,3 
011,10,013,2,022,013,3,022,013,4,022,013,5,022,3 



0I8PUY THE SISN.ON 
GET THE FIRST NUMBER 

EDIT AND MOVE TO FIELD I 



ttT NEXT NUMBER IF FIRST OK 
ELSE MAKE A NOIbE 
TRY AGAIN 

GET THE SECONU NUMBER 



HL 


Ml 


CALL 


OSPLY* 


LC 


9 


LD 


10 


LE 


2 


HL 


INPUT 


CALL 


KEVIN* 


LC 


4 


DE 


INPUT 


HL 


Fl 


CALL 


mDVEn 


JFC 


GETF2 


EX 


BEEP 


JMP 


GETFl 


LC 


5 


LD 


10 


LE 


3 


HL 


INPUT 


CALL 


KEYiNi* 



pAce 



>e 


4 


AODEK/TXT 




&5. 


1^125^" 


026 


Kii4 






bt. 


1W1252 


^i?4e 


W^'H 


l?3h 


■^2i^ 


S7. 


lk525fr 


»l6b 


pt,*4 


«56 


-J2i^ 


5S. 


1^^262 


1^6 


M2ki 


C«21 




59. 


145265 


104< 


274 


»2i6 




60. 


11*270 


151 








61. 


10271 


104 


233 


020 




62. 












fc3. 


10274 


t926 


004 






64, 


10276 


066 


004' 


056 


-^20 


65, 


10302 


106 


2495 


(^21 




66. 


10305 


026 


0vi4 






67. 


10907 


066 


004 


fc^56 


020 


68, 


10313 


106 


205 


021 




69. 












70. 


10316 


106 


245 


?21 




71, 


10921 


066 


126 


056 


i420 


72. 


10929 


142 


162 


e>02 




73, 












74. 


10930 


026 


004 






75, 


10992 


066 


004 


056 


020 


76, 


10996 


106 


229 


021 




77, 


10941 


826 


009 






7«. 


10949 


066 


004 


056 


020 


79. 


10947 


106 


163 


021 




se. 












81. 


10352 


036 


012 






82. 


10394 


046 


005 






83. 


10956 


066 


004 


096 


020 


84. 


10362 


106 


162 


002 




85. 












86. 


10365 


026 


002 






87, 


10367 


066 


000 


056 


1.92(1 


88, 


10373 


1U6 


157 


0Pt2 




89. 


1037& 


066 


0^8 


3^*7 




9e>. 


10401 


074 


190 






Pi. 


10403 


150 


000 


002 




92, 


10406 


066 


144 


056 


42f? 


93. 


id4l2 


lf»d 


162 


0ts2 




94, 


U4i5 


U.4 


172 


i^20 




5*5. 












96. 












97. 












98. 












99. 












l«^. 












IMl, 












102. 












1*^3. 












Ik54, 


11^42^5 


07** 








1455, 












l«9b. 


1^421 


353 








lt'.7. 


1^^422 


364 








1»B. 













UATAPUINT CONFIUe^TlAL InFJRhaTIOw - SEE PAGE 1 
BIOKERIT SAMPLE P«OG«AH FEBKUAHY, 1975 



ADUIT 



LC 

OE 

Hi 

CALL 

JFC 

EX 

JMP 

LC 

Hi 

CALL 

LC 

HL 

CALL 

CALL 

HL 

CTC 

LC 

HL 

CALL 

LC 

HL 

CALL 

LO 
LE 

HL 
CALL 

LC 

HL 

CALL 

MLA 

CP 

JTZ 

HL 

CALL 

JMP 



MOVE A FIE 
AN ASCn F 
IT 13 ONLY 

THAN THE A 
C ■ 
l)E ■ 
HL ■ 



4 

INPUT 

f-2 

hovEn 

AOUIT 

BEEP 

GCTF2 

4 

Fl 

BCO 
4 

F2 
bCO 

ADD 

M2 

DSPLYf 

4 

F2 

ASCII 

9 

F2 

Z5UPH8 

10 
5 

F2 
D5PLV8 

2 

INPUT 

K£YIN» 

INPUT 

»X' 

UOUT* 

OSPLY* 
bETFl 



tUlT AND fiDvE IT TO F2 

CUMPUTE SU** IF UK 
ELSE MAKE A NOISE 
T«Y AGAIN 

CONVEkT Fl TO BCO 
CONvtMT F2 TO BCD 



ADD Fl TO F2 GIVING F2 
DISPLAY THE OVERFLOi* MESSAGE 
IF CARRY FLAG SET 

CONVERT F2 TO ASCII 



SUPPRESS LEADING ZEHOS 
LEAVE AT LEAST ONE DIGIT 



DISPLAY THE SUM 

WAIT FOR OPERATOR READY 

QUIT IF XIT COMMAND 

CLEAR T^)E SCf^FEN 
DO IT AGAIN 



MOVEN 



PUSH 

LWO 
LLE 



LD UF CMARACTERS TERMINATED BY A ^19 INTO 
lELO AND EDIT TH£ SOU*<CE FIELD TO at SURE 

LEADING BLANKS OW DIGITS AnQ IS NOT LUnGEH 
sen FIELD. 

NUMBER OF DIGITS IN ASCII FIELD, 
BEGINNING ADDRESS OF FIELD TERMINATED 9Y 016, 
BEGINNING OF ASCII FIELD, 

SAVE THE BEGINNING ADDRESS 

OF THE ASCII FIELD 

EDIT AND DETERMINE THE LENGTH 

OF THE FIKST FIELD 

SCAN OFF THE LEADINb BLANKS 



PAG£ 



1^9, 
11*'. 

uu 

112, 
113. 
114. 
119. 
116. 

nr. 
iiei. 
us>. 

120. 
181. 
128. 
ISS. 
12«, 
129. 
12«. 
12?'. 
126. 
129. 
19i« 
131. 
iS£, 
13$. 
134. 
13t). 

i3ei. 

13?-. 
13S. 

130. 
14B, 
14],. 

148. 
149, 
144. 
14S. 
146. 

i4y. 

148. 
149, 
15(9, 
191. 
192. 
193, 
194, 
199. 
196, 
197. 
190, 
199, 

lee, 

16U 
162. 





AOOEW/TXT 


042i 


i^7 






0424 


074 


^4e 




45426 


ll« 


046 


021 


10431 


302 






0432 


i)24 


mi 




0434 


320 






0435 


140 


lb? 


021 


0440 


106 


011 


002 


0443 


104 


023 


«i21 


^446 


307 






0447 


074 


019 




0491 


190 


103 


021 


0494 


074 


060 




0496 


140 


197 


021 


0461 


974 


072 




0403 


loe 


197 


021 


0466 


106 


011 


002 


0471 


302 






0472 


024 


001 




0474 


320 






0479 


100 


046 


821 


0900 


104 


197 


021 


0903 


060 






0904 


302 






0909 


024 


001 




0907 


140 


123 


021 


0912 


006 


060 




0914 


370 






0919 


106 


011 


002 


0920 


104 


104 


021 


0923 


070 






0924 


393 






0929 


304 






0926 


317 






0927 


106 


011 


002 


0932 


339 






0933 


346 






0934 


060 






0939 


301 






0936 


074 


015 




0940 


099 






0941 


074 


040 




0943 


U0 


190 


021 


0946 


006 


060 




id99» 


370 






0991 


106 


011 


002 


0994 


104 


123 


021 


0997 


006 


001 




W561 


012 






^962 


007 







OATAPOINT CONFIOENTIAL INFOwnATION - Sg£ PAGE I 
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SET A CHAMACTtW 

LEADING Blank is ok 
End of blanks 

DECREMENT THE LtNGTH CPUnTER 



CATCH SOURCE FIELD TOU LAWGE 

BUHP THE SOURCE FIELD POInTEH 

LOOP 

SCAN TO END OF SOURCE FIELD 

GET A CHARACTER 

CATCH ENO OF STRING 



MLOOPl 


LAM 
CP 


1 1 




JFZ 


ML00P2 




LAC 






SU 


1 




LCA 






JTC 


ME»<ROR 




CALU 


INCHLi 




JMP 


MLOOPl 


ML00P2 


LAM 






CP 


019 




JTZ 


Hi OOP 3 




CP 


«0' 




JTC 


HERROR 




CP 


•»'*1 




JPC 


HEKftOR 




CALL 


INCHi* 




LAC 






8U 


1 




LCA 






JFC 


HL00P2 




JMP 


HCRROR 


ML00P3 


POP 


RESTORE 


ML00P4 


LAC 






«U 


1 




JTC 


ML00P9 




LA 


•0» 




UMA 






CALL 


SNCHLS 




JHP 


HL00P4 


ML00P9 


PUSH 






LHD 


POINT 




LLC 






L8M 






CALL 


INCHL* 




LOH 






LEL 






POP 






LAB 






CP 


019 




RTZ 






CP 


1 f 




JFZ 


ML00P6 




LA 


»0' 


ML00P6 


LHA 






CALL 


INCHL* 




JMP 


ML00P9 


MERROR 


LA 

SRC 

RET 


I 



ELSE HUfT BE >0' THRU >9i 



0UHP KEHOI^y POINTER 
DECREHfNT THE COUNTER 



LOOP ZF MORE TO 60 

CATCH SOURCE FIELD TOO LARfiE 

PAD ASCII FIELD ZEROS 

ASCII POINTER 

C REGISTER IS HUM HANT TO PAD 

00 CONVERT IF End OF PAD 
PAD ASCII ZERO 

euMP HEHORY POINTER 
LOOP 

SAVE ASCII POINTER 
TO SOURCf FIELD 

GET CHARACTER 

BUMP SOURCE POINTER 



POINT TO ASCII 

CATCH END OF SOURCE STRING 
QUIT IF THERE 

CONVERT BLANK TO ZERO 

PUT DIGIT IN ASCII FIfcLO 
BUMP ASCII POINTER 
LOOP 

EXIT WITH ERROR FLAG 



PAGE 
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i6i. 










lfc4. 










105. 










1&6. 










167, 










168, 


1*»563 


016 


040 




169, 


10565 


307 






17*'. 


10566 


074 


060 




171. 


lkJ57e 


013 






172. 


1*571 


371 






173. 


10572 


106 


011 


002 


174. 


10575 


302 






175, 


10576 


024 


001 




176, 


10600 


320 






177. 


10601 


lie 


165 


021 


178, 


10604 


007 






179. 










lee. 










lai. 










162, 










183, 










164, 


1«)605 


016 


060 




185, 


10607 


307 






186, 


10610 


251 






187, 


10611 


370 






188, 


10612 


106 


011 


002 


189. 


10615 


302 






I9t?, 


10616 


024 


001 




191. 


10620 


320 






192, 


10621 


110 


207 


021 


193. 


10624 


007 






194. 










195. 










196. 










197, 










198. 










199, 


10625 


016 


06a 




2^3. 


10627 


307 






2«1. 


iy63«3 


261 






st'a. 


106^1 


370 






2«3. 


10632 


106 


011 


002 


2**4. 


JH635 


302 






2»5. 


li4636 


A2A 


001 




2^6, 


1064(4 


320 






297, 


1?641 


110 


227 


^2\ 


2»&8. 


li?64 4 


0fe)7 







Suppress leading zewus in a-, ascii field, 
c • num9ew of zehus tc buppress 

ML » FIRST OlbIT In FJELD 



ZSUPHS 
ZSLOOP 



LB 

LAM 

CP 

PFZ 

LMB 

CALL 

LAC 

SU 

LCA 

JFZ 

«ET 



101 



IMCML* 



ZSLOOP 



I'^ITIALIZE THE SUPPKESSION CM^R, 

GET A oisn 

SEE IF IT'S A ZERO 

OuIT IF ^ClT 

ELSE OVEhSTORE wITH BLANK 

BUHP THE HfMORY PUINTEH 

DECREMENT THE COUTNfcR 



LOOP IF MORE TO GO 
ELSE OUIT 



CONVERT A FIELD OF ASCII DIGITS TO BCD, 
C • NUMBiH OF DIGITS TO CONVERT 
HL ■ FIRST DIGIT ADDRESS 



BCD 


LB 


BCOLUP 


LAM 




XRB 




LMA 




CALL 




LAC 




SU 




LCA 




JFZ 




RET 



•8» 



INCHL* 



BCOLUP 



INITIALIZE THE XOH BITS 
GET A DIGIT 
STRIP THE ASCII BITS 
RESTORE DIGIT TO mEhqry 
POINT TO NEXT DIGIT 
D£CRe»*ENT The COUNTER 



LOOP IF MORE TO GO 
ELSE DONE 



CONVERT A FIELD OF dCD OlblTS TQ ASCII, 
C ■ NUH8ER OF DIGITS TO CONVERT 
ML ■ FIRST DIGIT AoawESS 



ASCII 


L0 


A3CLUP 


lk\* 




ORB 




LMA 




CALL 




LAC 




SU 




LCA 




JFZ 




RET 



t0' 



INCHL* 



aSCLUP 



INITIALIZE THE OR BITS 
GET A DIGIT 
PUT IN THE ASCII BITS 
RESTORE DIGIT TO MEMORY 
POINT TO NEXT DIGIT 
DECREMENT THE COUTTER 



UUOP IF MORE TO GU 
ELSE DONE 



PAGE 



AODEH/TXT 
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243??. 










2l»5. 










2U. 










212. 










21.1. 










214. 










219. 










2ie. 


10645 


026 


966 




217. 


18647 


066 


003 


317 


218. 


10692 


066 


007 


3H7 


219. 


10655 


201 






22<a. 


18696 


370 






221. 


10697 


202 






222. 


10660 


100 


264 


021 


223. 


10663 


970 






224. 


10664 


066 


082 


317 


22S. 


10667 


066 


806 


907 


229. 


10672 


2U 






227. 


10679 


370 






22t. 


181674 


202 






229. 


10679 


108 


901 


021 


290. 


10700 


370 






231. 


10701 


066 


001 


917 


232. 


10704 


066 


009 


907 


239. 


10707 


211 






294. 


10710 


370 






239. 


10711 


202 






236. 


10712 


108 


316 


021 


23f. 


10719 


370 






299. 


10716 


066 


000 


317 


299. 


10721 


066 


084 


307 


240. 


10724 


2U 






241. 


10725 


370 






242. 


10726 


202 






249. 


10727 


009 






244. 


10790 


970 






245, 


U791 


007 






246. 










247. 










248. 


10163 









ADD TWO FOUR-DIGIT «C0 NUi^SEttS TOGETHfeR, PUTTTING J^-i 'ifcSuLT In TMfc 
SECOND NUMSERi 

THE FIRST NaWBER IS IN Fl (FIELD 1), 

THE SECOND '"iUMBER IS IN F2 (FIEUD 2), 

THE CARRY FLAS -ILL ^l ON IF OVERFUOi««, 

INITIALIZE THE CAKRY BIAS 
WORK FROM RISMT TO lifl 



ADD 


LC 


•^10 


A004 


MLB 


F14.9 




HLA 


F2*3 




ADB 






LMA 






AOC 






JFC 


ADO 9 




LMA 




A0D3 


MLB 


Fl*2 




MLA 


F2*2 




ACB 






LMA 






AOC 






JFC 


A 00 2 




LMA 




ADD2 


MLB 


Fl*l 




MLA 


F2*l 




ACB 






LMA 






ADC 






JFC 


AODl 




U«A 




AODl 


MLB 


Fl+0 




MLA 


F2*0 




ACB 






LMA 






AOC 






RFC 






LMA 






RET 





EXIT CARRY FALSE IF NO OVERFLOW 
EXIT CARRY TRUE IF OVERFLOW 



END 



START 



UATAPOINT CONFIDENTIAL lNFOHMATIO^< - SEE PAGE I 
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lfc645 


*ou 


7ft 


♦ 2lh 












It'/lb 


AOOl 


236 


• 23fl 












107^1 


A0i)2 


229 


♦ 231 












i(»664 


A003 


222 


♦224 












10647 


A004 


♦ 217 














18274 


ADOIT 


50 


♦ 63 












1^629 


ASCII 


76 


♦199 












10627 


ASCtfP 


*200 


207 












10609 


BCD 


69 


68 


♦ 184 






. 




10607 


acouup 


♦ 188 


192 












01000 


BOUTS 


*9 


91 












01162 


05PLT1 


*10 


36 


72 


04 


93 






10000 


Fl 


*18 


44 


64 


217 


224 


231 


298 


10004 


F2 


*19 


97 


67 


79 


78 


83 


218 


10172 


SETFl 


♦ 37 


46 


94 










10233 


GETF2 


46 


♦ 90 


61 










!»1011 


INChUS 


♦ 12 


116 


126 


1139 


146 


157 


173 


l»0«tf 


ISPUT 


♦ 16 


40 


43 


93 


56 


87 


89 


'^1197 


AF.YIN* 


♦11 


41 


54 


88 








men 


>^l 


♦ 24 


35 












10126 


^2 


♦ 30 


71 












13144 


^3 


♦31 


92 












10597 


•^Ei^wrw 


115 


123 


125 


131 


♦ l«n 






1*5423 


M(.UDPl 


♦ 109 


117 












1(5446 


'*L00P2 


111 


♦119 


13M 










H»903 


M1.00P3 


121 


♦133 












10534 


''LG0H4 


♦ 134 


140 













229 232 239 



186 203 



A&g 


9 


AODEW/TXT 




i»523 


MLOLiPS 


U6 


*142 


1055k? 


MLOOPe 


154 


♦156 


i»42e 


MOVEN 


45 


58 


iei63 


STAHT 


♦ 35 


248 


10565 


ZSLOOP 


*169 


177 


10563 


ZSUPRS 


79 


♦ 168 



OATAPQINT CONfIOE'<»TlAl. jNfOHWATION m SEE PACfc I 
8 L K E I T SAHPue PROGRAM FEBRUARY, 1975 



158 



*1*)4 



93 LASEtS USED 



SECTION 6. BOOTMAKE COMMAND 



BOOT MAKE - Generate a DOS bootstrap cassette 



The BOOTMAKE command writes a DOS bootblock onto the cassette tape in the front 
tape deck. BOOTMAKE accepts no operands. To use it, the user simply enters: 

BOOTMAKE 

At the system console. The command asks if the cassette in the front deck is 
scratch. If it is, the tape is rewound and a DOS bootblock written onto it. 

The BOOTMAKE command does not reread the bootblock to insure that the cassette is 
good. On the other hand, the bootblock checks its own parity immediately upon loading and 
halts if it finds it has not been loaded properly. Therefore, the easiest way to check a DOS 
boot tape is to place it into the rear deck and boot from it. If the machine halts upon 
booting repeatedly and other boot tapes work on the same machine, then the boot tape 
which causes the boot operation to halt is not a good tape and should not t)e used. 
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SECTION 7. CAT COMMAND 

CAT - Display the contents ot the directory 

CAT l<name>)(</ext>)(:DR<n>)(,L) 
where: < name > specifies the filename or a portion of the filename, <ext>specifies the 

Directory entries are displayed in the form: 
NAME/EXTENSION {PFN)P 

7nZl^r U? ^^^.^'^^' ^''® "^"'^®'' '" ''^*®' ^°-°^^^^ ^"^ P *s the protection on the file (D 

than svslem 11"7T '"'"'"' '°^ "°"'^- '^ ''' ''' ''^'^^'^'^ '^ ^ ^ subdirectory other 
than system, the directory entry is displayed in the form 

NAME/EXTENSION-(PFN)P 

Ts^'efed '^n^ '""'''? h''"''*'^"^^^ ""*^^- ^" ^^'^^^^^^ searched/unless a specific drive 
IS keyed, and as each drive is scanned, the line 

— DRIVE n (subdirectory name): 

«. inn"^"'^!!'"? '^® "'^"'^^ "^^ "^"^''^ "'^ =^'^'°9 ^'^P'^y «° P3"se at the end of the line 
foU /',^! '' " ^^"^- °«P™^^i"9 'h« keyboard key causes the catalog display to 
terminate at the end of the line. » k r 

If the CAT command is parameterized by only an extension, only files of that extension 
Will be displayed. If the CAT command is parameterized by only a name, only files of that 
name (all extensions) will be displayed. If the CAT command is parameterized by a name 
and an extension, only files of that name and extension (all drives) will be displayed If the 
CAT cornmand is parameterized by only the drive number, only files on that drive will be 
displayed If only a portion of the filename is entered, all files beginning with the letters 
Keyed will be displayed. 
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SECTION 8. CHAIN COMMAND 



8.1 INTRODUCTION 



ZrlT, ^"^ ^«<'"«"'=« °' °'her DOS programs. This file -a" a'so s' oo- 

,hl„ . example, CHAIN could be used to run the SORT utility on several files anrt 

Las emeTd f i"r °' "!"' '"''■ ''' '''''"'' °" "'^ '^^''"^^ ooufd coZ te which 

^nt-H^ parameter to the CHAIN command. Another common use of CHAIN 

created hJ tJ.lL! IT ^ appending together combinations of the object files 

Issemr^firn °" ."'"^"^ "^"" '° "^ "^'^ '° ^"'^' '^^^ d3»« t° be printed in each 

P oTams This .! ^'k'"' ''""=' '^'^'"'"^ •" °"'^ ' '"^'^ °< "^^ -"t'^^ ^V^'em of 
programs. This can all be performed by the CHAIN program. 

line from ali'le ZT, '""If"! "^ °°^ '"^''°''' ^"'^^ ^°"''"^ *"^ ^ r°"''"« -"ich reads a 

program wo Id nn T" ' '*''°"'' ""'^^ ^°"""" '^ ^^''^^^ ^'^^^^'o^^. ^^^^ time any 
prog am »0"Jd normally request a line to be entered by the operator it will ge, the line from 

from Ihe operator "° '"^^ *''^' "^ '"""' " """"'"^ '^""^ '^^ '''^ '"^'^^^ °' 

oroor.^rL^"^"^.!""' '^"'^"^^ ""^ '^^^ keyboard entry routine (KEVINS), only DOS 
oL^on J nn^ t"h! '°"""^ '°' ''^'^ ^"'^ '"^y "« "^«'^' ♦'^"S «-=l"ding the general 

CHAIN nm^L°'', "°'^ •''^' "'^ ^"^'^ P^°9^^'" =^""°' "« <=a'l«d from within the 

CHAIN procedure unless ,t is the last command to be executed in that procedure If 
recursion ,s attempted, an error message is given and the procedure is aborted. The 
that an"«rnr r ^""^y^^^^" programs being run make an exit to the DOS that implies 

rxpressinc ,h. ?°"' i'".' ''' ^" ""'"'■ ^^' "'°' '^^^^^^ 9'^" "^ "^^ Pr°9ram 
expressing the error will be seer, on the screen after the procedure is aborted. 

macro' nrnlT'^' °T^ '^ " P''°=^''"ral macro facility. It allows the operator to define a 

tother DOS nrnn t' T."'™ '"" ""^'^ '''" "^'"^* '" '«™^ °' °'^«r Smaller operations 
other DOS programs). This procedure can then be invoked by simply giving the name of 

t e ZIZT IT '°k'' ^"^'^ '"°'''"'- ^'^ ^<^^'''°-' '-'"•'- °' <---- making w^in 
I,,h« , ? , ^°"^ conditional statements (including logical operations and micro 

this cln "t '"'"^' "°'" "^ ^''*"' '°'"'"^"'' ""^' ^"°" ^" ^'^°'* ^"'™'*«^ ^'"^"^'O" °' 
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8.2 ELEMENTARY CHAIN USAGE 

As mentioned in the introduction, CHAIN really does nothing more than simulate the 
operator when the standard DOS keyboard entry routine is called. The data to be entered is 
obtained from a file whose name is given on the same line as the CHAIN command. For 
example, one could edit a file called APPFILES using the standard DOS Editor. It could 
contain the following lines: 

APP TSDWS,TSDSTATH.DS/0V1 
APP DS/0V1,TSDSKED,DS/0V1 
APP DS/0V1,TSDINT,DS/0V1 
APP DS/0V1,TSDINIT,DS/0V1 

When one then entered the DOS command: 

CHAIN APPFILES 

the above lines would be entered in the sequence shown whenever the DOS requested 
another command line. The conceptual simplification and reduction in probability of operator 
error is obvious. Instead of having to remember the names of ail the files each time the file 
DS/0V1 is to be created, the operator need only remember the file name APPFILES. 

When the last line of the CHAIN file has been exhausted, and a new DOS corpmand is 
desired by the system, the DOS is reloaded and commands are agam accepted from the 
operator at the keyboard However, if the file is exhausted while a DOS program is 
requesting data, the CHAIN ABORTED! message is given and the program currently being 
executed is abandoned. 

Although the above example showed only DOS commands being given by the CHAIN 
program, it should be remembered that all keyboard entries requested through the standard 
DOS keyboard entry routine will obtain their data from the CHAIN file. For example, if in the 
above example the files not needed after the appending had taken place were to be killed, 
the file would have contained the following additional lines: 

KILL TSDWS/ABS 

Y 

KILL TSDSTATH/ABS 

Y 

KILL TSDSKED/ABS 

Y 

KILL TSDINT/ABS 

Y 

KILL TSDINIT/ABS 

Y 

Note that the Y' given after each KILL command is not another DOS command but is the 
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response to the message 'ARE YOU SURE?' that the KILL command displays. Another 
example would be one of an assembly. When obtaining listings, the assembler requests the 
entry of a heading. Thus, the CHAIN file would need to contain the heading as well as the 
assertibly command: 

ASM, TSDWS;XL 

DATASHARE 2.1 WORKING STORAGE 

Some DOS programs can go through a rather complex set of requests for input which can 
make them hard to use with the CHAIN program without making a mistake. For example, the 
old D0SASM4 used to ask for program options one at a time with a message for each. This 
is a nice feature if one is entering the data from the keyboard but, on the other hand, makes 
it almost impossible to use the program with CHAIN without making an error in the 
procedure file. The problem is aggrevated by the fact that the number of options requested 
varies depending upon the response to certain options. For this reason, most DOS programs 
allow almost all options to be specified on the command line and keep the variation in the 
number ofkeyin requests to a minimum. It is good practice for all DOS programs to be 
written with this in mind to facilitate their use with CHAIN. 

An additional Item to keep in mind is the fact that some DOS programs use their own 
keyboard entry routine as well as the one provided by the DOS. This enables the program 
to avoid the use of the CHAIN procedural lines when special operator intervention is 
required. An example is the TAPE program (industry compatible 9-track tape handler) which 
requests operator intervention if the end of the reel of tape is reached while a file is being 
written. In this case, the program asks if the writing is to be continued on another reel of 
tape and if so waits for the operator to change reels. After the operator indicates to the 
program that the reel has been changed, the program can continue writing files, getting the 
names from the CHAIN procedural file. If the TAPE program had used the standard DOS 
keyboard entry routine, the file names would have been given for reel change responses and, 
needless to say, the order of program execution would have been incorrect. 

8.3 ADVANCED CHAIN USAGE 

8.3.1 Tag definition 

The CHAIN command line can be parameterized by tags given after the procedural file 
specification. If tags are given, the file specification must be followed by a semicolon. Tags 
may be from one to eight characters in length and have values from zero to eight characters 
in length. A tag's name must start with a letter and contain only letters or or digits. A 
tag's value can contain any character except the <#>symbol. A tag is given a non-null 
(non zero length) value by enclosing the value to be assigned between <#>symbols. For 
example, in 

CHAIN MAKETEST;LIST,DAY#17#,TIME#02:30# 

the tag LIST has a null value, the tag DAY has the value 17, and the tag TIME has the value 
02:30. CHAIN allows two uses to be made of tags. Tests can be made to determine 
whether a tag of a given name has been entered on the CHAIN command line and the value 
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of a tag can be substituted for part of a line within the procedural file. 

8.3.2 Phases of execution 

CHAIN executes a compilation phase and an execution phase. In the compilation 
phase (CHAIN/CMD), the specified procedural file is read and a new file is created (always 
named *CHAIN/SYS) and deleted at the successful completion of the procedure. This new 
file consists of only the lines to be used in the particular procedure to be executed. All 
compilation comment lines and conditional items not to be used are eliminated, all 
substitutions of tag values are made where indicated, and the space compression in the file 
is eliminated to make it easier on the routine that overlays the DOS KEYIN$. 

The execution phase (CHAIN/0V1) overlays the DOS KEVINS with a routine which fits 
in the same space and appears the same upon exit (the HL and DE registers are the same 
as if data had been entered from the keyboard and the display and cursor positioning on the 
screen is the same) except the input line is obtained from the *CHAIN/SYS file instead of 
from the keyboard. If the line read in is longer than the maximum specified by the calling 
program, the procedure is aborted. 

After the KEVINS routine is overlayed, the execution phase reads in one line and 
supplies it to the DOS as if the line had been keyed in as a DOS command. If this 
produces an execution time comment line, the line is simply displayed and another line is 
read (which may also be an execution comment). Execution time comments are denoted by 
having a //. as the first three characters in the line. There is a variation on the execution 
time comment called an operator break point. This line is denoted by having a //*as the first 
three characters in the line. This line is displayed as in an execution time comment except 
afterward the machine wait for an operator to depress the KEYBOARD or DISPLAY key. After 
one or the other of these keys is depressed, the machine will continue to the next line as in 
an execution time comment. 

If the end of the *CHAIN/SVS file is reached while a DOS command is being sought, 
the procedure is determined to be finished. At this point the •CHAIN/SYS file is deleted and 
the DOS is reloaded (restoring the KEVINS routine to its normal state). Otherwise, the DOS 
is entered just after the point where it calls KEVINS to read the command with the command 
line set up in MORS. This latter action causes the next DOS command to be off and 
running. 

When the DOS program jumps to the DOS EXITS entry point or to the label NXTCMD 
in the command interpreter, which indicates that the program is finished and the next DOS 
command should be accepted, the routine overlaying KEVINS loads and executes the 
CHAIN/0V1 file which reloads the DOS, restores the CHAIN KEVINS routine, and then reads 
the *CHAIN/SVS file for the next DOS command. 
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8.3.3 Tag exi8tonc« testing 

CHAIN contains an IF operator which allows i test to be made for the existence of one 
or a number of tags in the CHAIN command line. If the test proves positive, then the lines 
following the one the IF operator is on will be included in the *CHAIN/SYS file. If the test 
proves negative, then the lines will be deleted. This will hold true until either the ELSE or 
XI F operators discussed below are reached. Note that all CHAIN operators are denoted by 
having a // appear as the first two characters In the line. If the third character is 
additionally a period, then an execution time comment is indicated. Otherwise, any number 
of intervening spaces (including zero) are scanned until an operator is reached. If the 
operator scanned in is not one of the defined operators, an error message will be given and 
the procedure aborted. The examples all show one space between the two slashes and the 
operator in order to make them more readable. 

The IF operator has two variations, IFS and IFC which stand for if-set and if-clear. The 
IFS operator proves positive If any of the tags listed exist. For example: 



// IFS FLAG1,FLAG2,FLAQ5 

will prove positive if FLAG1 or FLAQ2 or FUQ6 WM msntloned In the CHAIN comm^and 

line.The 

example: 

// IFC FLAG2.FUG3,FLAG7 



line.The IFC operator proves positive If any of the tags listed were not mentioned. For 



Will prove positive if FLAQ2 or FLAGS or FLAG? was not mentioned in the CHAIN command 
line. One can test to see if all of a group of tags exist by having multiple IF statements m 
sequence. For example: 

// IFS FLAG1,FLAG3 
// IFS FLAG2 
// IFS FLAG7 

will allow the following lines to be used in the procedure if FLAG1 or FLAGS is set AND if 
FLAG2 is also set AND if FLAG? Is also set. Note that the comma between tag names on 
an IF line actually performs the logical OR function. The logical AND function may also be 
perfored by putting a period between tag names. For example: 

// IFS FLAG1.FLAG2,FLAG3,FLAG4.FLAQ5.FLAQ6 

will allow the following lines to be used in the procedure If FLAG1 and FLAG2 exists or if 
FLAGS exists or if FLAG4 and FLAGS and FLAG6 exists. Note that th^lF operators are 
scanned only if procedure lines are being used. Thus, if one of the IF operators has proven 
negative and has inhibited the use of procedure lines, all following IF operators will be 
ignored until one of the following two operators are reached. 
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As mentioned in the first paragraph of this section, the two CHAIN operators that can 
cause procedure lines to be put back into use are ELSE, which reverses whether or not the 
procedure lines are being used, and XIF, which unconditionally turns on the usage of 
procedure lines. For example, if the CHAIN file MAKETEST contained the following; 

// IPS LIST 

ASM TEST;XL 

TEST PROGRAM 

// ELSE 

ASM TEST 

// XIF 

APR DATA,TEST,TEST/CMD 

and the CHAIN command was given as follows: 

CHAIN MAKETEST;LIST 

then the procedure followed would be: 

ASM TEST;XL 

TEST PROGRAM 

APP DATA,TEST,TEST/CMD 

However, if the chain command was given as follows: 

CHAIN MAKETEST 

then the procedure followed would be: 

ASM TEST 

APP DATA,TEST.TEST/CMD 

Actuaify; ELSE and XIF can be inhibited by the use of the BEGIN and END operators 
discussed in Section 8.4.5. 

8.3.4 Comment lines 

if 

CHAIN allows for two types of comment tines within the procedural file. One type 
already mentioned is the execution time comment. This type may appear only before a DOS 
command entry and will not appear until just before that command is to be executed. For 
example, the procedure file containing: 

//. ASSEMBLY OF THE TEST PROGRAM 
ASM TEST;XL 
TEST PROGRAM 

would cause the first line to be displayed before the assembly was executed. A variation on 
the execution time comment is the operator break point. 
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For example, the procedure file contining: 

//^INSERT TAPE Z12548 INTO THE FRONT CASSETTE DECK 



TEST 
DATA 



LGO process. * rNtrBUAHD or DISPLAY Key and then continue with the 

includld'inT"' *''! °' '°'^"^""* """ '" " compilation time comment. This line is not 
about to r^ZLt CHaIn ^ ^ ' " — nicating to the operator what procedure is 

procedTr^LrifllTas l:i^ ''''""'' (not displayed or written) just as the other 

reached FrexLp e f the fnT ^^ ' '"' '" ^'^^ "^ ^'^ ^P^^^*°^ ^^^ '^' b^«n 
hor example, if the following procedure file MAKETEST was created: 



. ANTIDISCOMBOOBERATOR TEST PROGRAM 

// IFS LIST 

• YOU ARE GOING TO GET A LISTING 
ASM TEST;XL 
TEST PROGRAM 
// ELSE 

. YOU AREN'T GOING TO GET A LISTING 
ASM TEST 

and the CHAIN command: 

CHAIN LIST 

was given, then only the lines: 

. ANTIDISCOMBOOBERATOR TEST PROGRAM 
YOU ARE GOING TO GET A LISTING 



rdlmr." " ''" CRT screen before the procedure is executed. If. however, the CHAIN 



command: 

CHAIN MAKETEST 
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was given, then only the lines: 

ANTIDISCOMBOOBERATOR TEST PROGRAM 
. YOU AREN'T GOING TO GET A LISTING 

will appear on the CRT screen before the procedure is executed. 

8.3.5 Tag value substitution 

So far in the discussion the value of a tag has not been used. Note that the existence 
of a tag can be tested regardless of its value. Thus the procedure file can test to see if any 
tags with values have been forgotten by the operator. A tag value is simply substituted 
wherever a pair of <#>symbols are found with a syntactically valid tag name between 
them.An example will eliminate a large number of words. Lets assume that the procedural 
file MAKETEST looked as follows: 

ASM TEST;XL 

TEST PROGRAM ASSEMBLED ON #DATE# 

ASM ASDF;L 

THE ##FLAG1##PR0GRAM #FLAG2# 

//. ##FLAG1##FLAG3#FLAG2# 

A CHAIN command of: 

CHAIN MAKETEST 

would produce a *CHAIN/SYS file that looked exactly the same since if the tag between 
<#>symbols does not exist, then no substitution at all is 
performed. However, a CHAIN command of: 

CHAIN MAKETEST;DATE#17JAN74#,FLAG1#QWER#,FLAG2#ZXCV# 

would produce a *CHAIN/SYS file as follows: 

ASM TEST;XL 

TEST PROGRAM ASSEMBLED ON 17JAN74 

ASM ASDF;L 

THE #QWER#PROGRAM ZXCV 

//. #QWER#FLAG3#FLAG2# 

Observe, for a moment, how the <#>symbols were handled in the next to the last 

line. The first two <#>symbols did not enclose a syntactically valid tag name. Therefore, 

the first <#>was simply passed through and a pairing <#>for the second <#>was 

sought. This was found and a syntatically valid name (FLAG1) was found to be 

between. So the value of FLAG1 was substituted for the characters #FLAG1#in the line and 

then the scan continued. The following pair of <#>enclosing the word PROGRAM was not 

used as a tag name because the word PROGRAM was terminated by a space. To be used 

for a tag name, the substitution specification must be terminated by the <#>symbol. 
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Now observe the last line In the example above. The first three <#> symbols were 
handled in the same way as for the next to the last line. However, #FLAG3#did make up a 
syntatically valid substitution specification so it was used. FLAGS did not exist so 
#FLAG3#was simply passed through. At this point however, the only 
characters remaining to be scanned were FLAG2#which did not make a matching set of 
<#>symbols so FLAG2#was simply passed through also. 

Also observe how the above example eliminated a large number of words. Imagine 
what the explaination would have been like if an example had not been used. All of the 
above may seem a bit far fetched but the features explained are very useful when one wants 
to use the CHAIN command from within a CHAIN procedure. For example, one could pass 
the date from one procedure to the next by having the procedure file: 

ASM TEST;XL 

TEST PROGRAM ASSEMBLED ON #DATE# 

CHAIN CHAINF2;DATE##DATE## 

Note that if a tag is mentioned in the CHAIN command line but given no value and if the 
value is called for substitution, a null value will be substituted for the #<tag>#within the 
line. The effect is that the #<tag>#characters simply disappear from the line. For 
example, a CHAIN command: 

CHAIN MAKETEST;DATE 

made for the procedural file shown above (assume it was called MAKETEST) would result in 
a *CHAIN/SYS file containing: 

ASM TEST;XL 

TEST PROGRAM ASSEMBLED ON 

CHAIN CHAINF2;DATE## 



8.3.6 Additional CHAIN operators 

in addition to the ones mentioned in previous sections, CHAIN contains ABORT, BEGIN, 
and END operators. The ABORT operator simply causes CHAIN to return instantly to the 
DOS without any further action. If any messages are to be given to the operator, it is the 
responsibility of the procedural file to contain the appropriate compile time comments before 
the ABORT operator. This operator makes it easy to terminate the procedure if a critical tag 
is missing or some other problem with the procedural file or its parameterization is detected. 

The BEGIN and END operators allow groups of IF/ELSE/XIF operators to be 
parenthesized. A counter called the BEGIN/END counter is initialized to zero when CHAIN is 
started. If the use of procedural lines is turned off and a BEGIN operator is encountered, 
then the BEGIN/END counter is incremented. If an END operator is encountered, then the 
BEGIN/END counter is decremented unless it is already zero. The ELSE and XIF operators 
have no effect if the BEGIN/END counter is not equal to zero. 
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for example 

/ IFS FLAG1 
ASM TEST1;XL 
TEST PROGRAM ONE 
// ELSE 
// BEGIN 
// IFS FLAG2 
, ASM TEST2;XL 

TEST PROGRAM TWO 

// ELSE 

ASM TESTTEST;XL 

TEST TESTER 

// XIF 

// END 

// XIF 

// IFS FLAG3.FLAG27 

LIST SCRATGH;L 

THE SCRATCH FILE AT FLAG 27 

// XIF 

The 6th through the 12th lines will not be used if FLAG1 exists, not withstanding the fact 
that there is an ELSE and XIF operator within those lines, because the BEGIN/END pair 
prevented these operators from having any effect. 

8.3.7 Resuming an aborted CHAIN 

Before the CHAIN overlay fetches the next DOS command it stores the *CHAIN/SYS file 
pointers for the line to be used. If something goes wrong during the DOS command which 
follows and the procedure is aborted, CHAIN still knows where it was in the *CHAIN/SYS file 
when the problem occurred. Since CHAIN does not delete the •CHAfN/SYS file unless the 
procedure completes successfully, it can pick up where it stopped in the *CHAIN/SYS file if 
the operator can correct the condition which caused the procedure to abort in the first 
place. Often, the reason for the abort is something correctable like the disk running out of 
files or an attempt to delete a non-existent file. In this case, the opeiator need only correct 
the condition and then enter: 

CHAIN * 

and the procedure wili pick up with the command which failed before. This action can be 
applied even if the RESTART key has been depressed. Thus, one can recover from jammed 
paper in a printer half way through an assembly by simply depressing RESTART, fixing the 
printer, and then typing the CHAIN *command. 
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SECTION 9. CHANGE COMMAND 



CHANGE - Change a file's protection 
CHANGE <file speo/p 



The CHANGE command enables the user to write protect, delete protect, or clear the 
ZTnZ. IT f V^'^'^ °' ^"'^ protected, a KILL command (or program generated kill) 
cannot affect it. If a file is write protected, it cannot be written into by the standard system 



The second specification is used to indicate the protection for the file specified The 
extension portion of the specification is used to present the parameter: 



D - delete protect 
W - write protect 
X - clear protection. 



For example: 



CHANGE NAME/EXTENSION /D 
CHANGE NAME /X 

will delete protect the file in the first case, and remove all protection in the second case If 
a first specification is not given, the message 

NAME REQUIRED. 

will be displayed. If the file indicated by the first file specification cannot be found, the 
message 

NO SUCH NAME. 

will be displayed. If the second specification does not follow the above syntax rules the 
message 

INVALID PROTECTION SPECIFICATION, 
will be displayed. 
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SECTION 10. COPY COMMAND 



copy - Copy a file from one place to another 

10.0 PURPOSE 

It is frequently useful to make a copy of a disk file. It may be desired, for example, to 
make a copy on a separate volume for backup or distribution purposes. 

It IS possible to copy a disk file using more specialized commands such as SAPP and 
APP, However, since these commands make assumptions regarding the internal details of the 
contents of the file they are copying, they require the user to distinguish between standard 
DOS TEXT-type files and OBJECT files (files whose contents are in the standard format 
acceptable to the DOS loader). Additionally, SAPP and APP cannot correctly copy certain 
unusual types of files, for example those with imbedded end-of-file records, DATABUS 7 and 
DATASHARE physical random data files, and the like. 

Because the COPY command does not make assumptions about the format of the 
sectors being copied, but merely copies the file sector-for-sector, it can copy most types of 
disk files which previously were not possible to copy using the SAPP and APP commands. 
Some particular types of file are still unmovable, however. The outstanding example are 
Index files, usually with extension /ISI. (These cannot be moved because index files contain, 
internal to themselves, pointers indicating their actual physical location on the disk volume, 
which are made invalid when the file is moved to another place on the disk). 

Another advantage of the COPY command is that since sectors are not examined for 
content, the command can copy files much faster (particularly under DOS.B) than is possible 
using APP or SAPP. 

10.1 USE 

The COPY command is invoked by entering at the system console: 

COPY < input file spec>,< output file speo 

The COPY operation causes the first specified file to be copied into the second one. 
Attributes of the first file, such as its protection, are copied to the second file as well. 

The only portion of the operands that is specifically required is the name of the input 
file. The extension of the input file, if none is specified, is assumed to be /TXT. If a drive 
specification is entered for the input file, then only that specific drive is searched for the 
indicated file. If no drive specification for the input file is given, all drives are searched. If 
the name of the output file is omitted, it is assumed to be the same as that of the input file. 
If the output file's extension is not given, it is also assumed to be the same as that of the 
input file. All drives are searched for the output file before creating it unless a particular 
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drive is specified. 

For example, to copy file PAYROLL/TXT from drive two to drive one, it is only 
necessary to enter at the system console: 

COPY PAYR0LL:DR2,:DR1 

As another example, to make another copy of PROGRAM/ABS on drive zero, but to be 
named MYPROG, all that is required is: 

COPY PROGRAM/ABS,MYPROG:DR0 
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SECTION 11. DOSGEN COMMAND 



DOSGEN - Prepare a disk for use by DOS 

11.1 PURPOSE 

Before any disk can be used by the DOS, certain tables and otiier information must be 
placed onto it to establisii the basis DOS requires for tfie support of its file structure. These 
tables include the 8l<eleton of the DOS directory, where the names of the files contained on 
the disk are stored, as well as a map showing which places on the disk are bad and should 
not be used. 

The purpose of the DOSGEN command Is to provide the user with a simple and 
efficient way of accomplishing this. 

11.2 USE 

To DOSGEN a disk, the user enters at the system console: 

DOSGEN < drive speo 

The drive spec field is a standard DOS drive specification which specifies which drive 
contains the disk to be prepared for DOS usie. Since the command during the directory 
initialization process will effectively KILL any files that might be on the disk, the command 
asks the user several times to make sure that he is aware of the potential seriousness of the 
operation he has invoked. 

After the user has acknowledged that he does not mind the overwriting of the new 
disk, the command asks If any cylinders on the volume are to be locked out. Normally, the 
answer to this question is NO. However, by answering YES, it is possible to cause the DOS 
to lock out one or more cylinders of the disk from DOS access. This can be useful in some 
special applications where it is desired to not allow DOS programs access to a file stored in 
unusual format, for example. In general, locking out cylinders from DOS access is to be 
discouraged since it makes it more difficult to make use of the useful features of the DOS. 
If the user does wish to lock out any cylinders, he may do so by specifying one or more 
cylinder numbers, in the format: 

12,14,16,25-28,40 

The above example would cause cylinders 12, 14, 16, 25, 26, 27, 28, and 40 to be 
locked out. Note that the cylinder numbers to be locked out are given in decimal as 
opposed to octal. 

After the user has specified that no, or which, cylinders are to be locked out, the 
DOSGEN command checks for bad sectors on the disk and issues a message indicating any 
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cylinders it finds which contain bad sectors. The remainder of the operation is completely 
automatic and indicates its completion with the familiar DOS message, 'READY'. 

Upon completion of the DOS generation process, the only files on the new disk are the 
eight system files SYSTEIVIO/SYS through SYSTEM7/SYS and the CAT command. 

11.3 SPECIAL CONSIDERATIONS 

It is important to remember that on disk packs for use with DOS systems recognizing 
more than one logical drive per physical disk pack, for example the 9370 series' disk system, 
two DOSGENs must be done before the physical pack is fully initialized. This allows the 
user to DOSGEN either logical disk on the pack without disturbing files he wishes to keep 
that may be stored on the other logical disk. 

Another important thing to remember is that both the 9370 and 9380 series disks must 
be formatted before DOSGEN can be used on them. Diskettes (for the 9380 series drives) 
come pre-foi matted from the manufacturer; disk packs for the 9370 series drives do not. It 
IS therefore necessary to format all disk packs for the 9370-series drives using the program 
INIT9370 before attempting to use DOSGEN on them. 
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SECTION 12. DUMP COMMAND 



DUMP - Display sectors from disk in octal 

12.0 PURPOSE 

Occasionally while writing into files on disk (In particular, during the program debugging 
stage) It is useful to be able to verify that the formatting of the information into the standard 
text format is being done correctly. Or, perhaps an assembler language program (/ABS file) 
that previously loaded correctly no longer will, as indicated by the DOS just coming back up 
when the program is run. 

The DUMP command gives the user a simplified mechanism for examining the entire 
contents of physical sectors on the disk. The display includes both the octal and ASCII 
contents of every byte on the sector. No examination for control bytes of any kind is made, 
allowing the user to see the precise contents of every physical location in the disk sector. 

Another good use for the DUMP command is to clarify any questions regarding the 
standard DOS file formats. Using DUMP it Is possible to examine a file and see just how it is 
formatted on the disk. DUMP is frequently useful for DATASHARE programmers who are using 
tabbed reads and writes and encounter problems with their programs, since these problems are 
usually caused by a lack of complete understanding of the format of DOS standard text files 
and how this interacts with tabbed disk operations in DATASHARE. 

12.1 USE 

The PUMP command Is Invoked by entering at the system console: 
DUMP 

The DUMP command operates with basically four separate levels of control. These 
levels are: 

LEVEL ONE - Logical drive level 

LEVEL TWO - File level 

LEVEL THREE - Logical record number level 

LEVEL FOUR - Physical disk address level 

When the DUMP command is used, the top line on the display is the control line. All 
input is accepted on this line. This line is broken into four basic areas, one corresponding 
with each of the four control levels. The control level at any given time during the operation 
of the DUMP command can be determined by the position of the flashing cursor on the control 
line. 
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For example, if the flashing cursor is positioned after the 'DRIVE:' legend on the control 
line, the DUMP command is operating at level one. If the cursor is positioned after the 'FILE:' 
legend on the control line, the DUMP command is operating at level two. And so forth. 

12.2 INFORMATIONAL MESSAGES PROVIDED 

The second line on the display is used for sector informational messages. These serve 
both to indicate any special significance of the sector just read and to describe any unusual 
occurrences associated with reading the sector. These messages are generally 
self-explanatory. Among the messages that can be displayed are the following, along with an 
explanation of the meaning of each. 

RETRIEVAL INFORMATION BLOCK (RIB). This message indicates that the sector being 
displayed is the primary RIB for the currently opened file. 

RETRIEVAL INFORMATION BLOCK BACKUP. Each RIB is maintained in duplicate for 
backup purposes and to allow recovery in the event of a program erroneously destroying the 
primary RIB. This message indicates that the sector being displayed is the secondary RIB for 
the currently opened file. Note that this does not mean that the primary RIB has necessarily 
been damaged; it simply means that the sector requested happens to be the secondary, 
backup copy of the RIB. 

CLUSTER ALLOCATION TABLE. This message indicates that the sector being displayed 
is the primary Cluster Allocation Table (normally referred to as the CAT) for the current logical 
drive. 

CLUSTER ALLOCATION TABLE BACKUP. This message indicates that the sector being 
displayed is the secondary, backup CAT for the current logical drive. This implies that the 
CAT is also maintained in duplicate just as is the RIB. 

LOCKOUT CLUSTER ALLOCATION TABLE. Associated with each logical drive is a 
sector that indicates which areas have been locked out, prohibiting their use by the DOS. 
This message indicates that the sector being displayed is the Lockout CAT for the current 
logical drive. 

LOCKOUT CLUSTER ALLOCATION TABLE BACKUP. This message indicates that the 
sector being displayed is the secondary, backup copy of the sectoi- just described above. 

SYSTEM DIRECTORY SECTOR. This message indicates that the sector being displayed 
is one of the DOS directory sectors. The directory sector number (in decimal) immediately 
follows the message. 

USER DATA SECTOR. This message indicates that the sector is not one of the above 
special system sectors. 

DISK SECTOR CROC ERROR. This message indicates that the sector requested for 
display either was not found on the disk or that a CRCC error repeatedly occurred during the 
read operation. The sector displayed is the data as it was read from the disk, unless the 
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sector was not found. 

DISK OFFLINE. This message indicates that the currently specified logical drive is not 

on line. 

DISK SECTOR FORMAT ERROR. This message is displayed when DUMP notices that 
the sector being displayed does not correspond to standard DOS file conventions (the first byte 
of each sector is its physical file number, and the two following bytes are the logical record 
number). The appearance of this message does not necessarily indicate that the sector of the 
file has been destroyed, since unwritten sectors at the end of a file and older version 
DATASHARE object code files normally will fall into this class. It merely means that if the 
sector were read with the DOS READS routine, a format trap would occur. 

SECTOR OUT OF RANGE. This message is displayed if the sector requested (by logical 
record number) is not within the range of the currently opened file. 

FILE NOT FOUND. This message indicates that the file requested could not be found. 
This does not necessarily mean that the file does not exist. For example, the user and the file 
could be in two different subdirectories. If the user has not requested non-specific volume 
mode {to be described), this message might mean simply that the file desired is on a different 
logical drive. 

INVALID PHYSICAL ADDRESS. This message indicates that the physical disk address 

specified is invalid. 

The remainder of the display contains the contents of the current half of the sector most 
recently read. The display is arranged as eight groups of sixteen bytes each. Each of these 
groups is preceded by the three octal digit offset of that group within the sector. Each 
sixteen byte group consists of the octal and ASCII contents of each of the sixteen bytes in 
that group. Each byte's contents form a column one byte wide and four lines high, where the 
first three lines are the value of the byte, in octal, and the fourth line is the ASCIi value of 
that character. Notice that the character Is not examined for special significance before it is 
displayed, so that users with computers having the high speed RAM display option (which is 
strongly recommended for all DOS systems) may display characters other than the normal 
ASCII set. 

12.3 LEVEL ONE COMMANDS TO DUMP 

When the flashing cursor Indicates that DUMP is functioning at level one, the following 
commands are accepted: 

< enter >- The CAT on the current drive is displayed and control transfers to level two. 
In addition, the non-specific drive mode is enabled. 

number - The drive number indicated becomes the currently selected drive. The CAT 
from that drive is displayed and control is transferred to level two. Non-specific drive mode is 
disabled. 

*- DUMP command returns control to the DOS. 

>- The second half of the current sector is displayed. 
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<- The first half of the current sector is displayed, 

12.4 LEVEL TWO COMMANDS TO DUMP 

When the flashing cursor indicates that the DUMP command is functioning at control 
level two, the following commands are accepted: 

<enter>- If a file is currently opened, the secondary RIB for the file is displayed and 
control transfers to level three. If no file is opened, control transfers to level four. 

name/ext - The named file is opened on the current drive, or any drive if non-specific 
drive mode is enabled. The primary RIB for the file is displayed and control transfers to level 
three. 

pfn - The file indicated by the octal physical file number given is opened on the current 
drive. The primary RIB for the file is displayed and control transfers to level three. 

I - The current physical file number is incremented and the new file thus indicated is 
opened. If no file corresponding to that physical file number exists on the current drive, the 
PFN is incremented repeatedly until a file corresponding to the PFN is found. The primary 
RIB for the file is displayed and control transfers to level three. 

D - D works just like I just described except that instead of incrementing the PFN, it is 
decremented. 

#pfn - Show the directory sector containing the entry corresponding to the file indicated 
by the specified physical file number. Since only the last four bits of the PFN are relevant, 
the pfn specifier is equivalent to a relative directory sector number. All directory sector 
numbers are always specified in octal. 

*- Return control to level one. 

>- Show the second half of the current sector. 

<- Show the first half of the current sector. 

12.5 LEVEL THREE COMMANDS TO DUMP 

When the cursor indicates that DUMP is functioning at level three, the LRN level, the 
following commands are accepted. 

< enter >- Show the current sector and transfer control to level four. 

number - Access and display the record indicated by the LRN specified. If the number 
given has a leading zero, it is assumed to be octal; otherwise it is assumed to be in decimal. 
The number specified is the user (as opposed to system) LRN. The system LRN, the one in 
bytes one and two in the sector, is always two less than the user LRN. The two numbers 
displayed at level three in the control line are the LRN in decimal (the one with leading zeros 
suppressed) and octal (the one in parentheses, with leading zeros). 

I - Increment the current logical record number, access it and display the sector. 

D - Decrement the current logical record number, access it and display the sector. 

*- Return to the File level of control (level two). 

>- Show the second half of the current sector. 

<- Show the first half of the current sector. 
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12.6 LEVEL FOUR COMMANDS TO DUMP 

Level four of the DUMP command requires more detailed understanding of DOS physical 
disk addresses, and as such is not usually as useful as the LRN level. However, when access 
to a specific sector on the disk is desired, it can be achieved using DUMP level four. It is 
important to realize that the physical disk addresses specified are logical physical disk 
addresses, i.e. the same format as is given to the DR$ and DW$ routines in the DOS. They 
are not necessarily the same as actual physical locations on the disk. For example, with 
DOS.C for the 9380 series diskettes, the logical disk addresses are remapped onto the diskette 
into different hard physical sector numbers than those indicated by the logical physical disk 
address. The important thing to understand here is that the disk addresses used in the level 
four control of DUMP are those that would be used to parameterize DR$ and DW$. 

The commands accepted at level four of DUMP are as follows. 

msb,lsb - Access and display the sector indicated at the given physical disk address on 
the current logical drive. The most significant byte is assumed to be in decimal unless a 
leading zero is supplied. The second byte is always considered to be in octal, regardless of 
whether a leading zero is supplied or not. 

*- Return control to level two if no file is opened, or level three otherwise. 

>- Show the second half of the current sector. 

<- Show the first half of the current sector. 

12.7 ERROR MESSAGES 

Only one genuine error message Is issued by the DUMP command. It is: 

ERROR IN DOS FUNCTION. DUMP ABORTED. 

If this error message occurs, it means that the DOS FUNCTIONS are probably incorrect 
on the disk, generally indicating that the disk in drive zero has not been completely (or 
correctly) DOSGENed. If this is the case, SYSTEM7/SYS should be loaded using the latest 
copy of the DOS as distributed by Datapoint. 
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SECTION 13. EDIT COMMAND 



13.1 INTRODUCTION 

The DOS Editor enables the user to create and to update source data files on the disk. 
The editor, through the use of initialization parameters, will enable the user to create files in a 
variety of formats: text files, assembler code files, DATABUS source code files, or user 
designed data files. 

A GLOSSARY of the many terms and phrases used throughout this manual is provided in 
subsection 13.8 and a list of commands and brief definitions is provided in subsection 13.9. 

Throughout the section these conventions will be used: 

Square brackets - {}- indicate optional fields. 
Pointed brackets - <>- indicate required fields. 

Caution: Although virtually any Datapoint format file may be 'edited', files structured with 
respect to physical records or those containing strings longer than 79 characters may find that 
organization collapsed as the editor compresses the file Into sequential format. In such cases 
the editor should not be used. 

13.2 OPERATION 

13.2.1 DOS INITIALIZATION 

The EDIT program, catalogued EDIT/CMD on your disk, is parameterized as follows: 
EDIT <f1>{,f2}{,f3}{;parameter list} 

13.2.2 Files 

<f1>is the source file, <f2>is the scratch file and <f3>is the configuration overlay 
file. The source file <f1>is assumed to have an extension of TXT if none is provided. If 
there is no file of the specified name, one will be opened. If no scratch file <f2>is specified, 
a file SCRATCH/TXT' will be used. The configuration file <f3>is assumbed to be 
EDIT/0V1 unless otherwise specified. 

If parameters are indicated by the presence of the semi-colon, the question: 
RECORD PARAMETERS? 
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will be displayed. If N' is entered, the editor will begin execution with the indicated 
parameters and the configuration file will not be changed. If Y' is entered, the question. 

NEW TABS? 

will be asked. If Y' is entered, the standard tab initialization line of numbers will be displayed 
(see ;T command description). After the new tabs are entered, the parameter information and 
tabstops are recorded in <f3>. 

If no parameter list is provided, <f3>, if present, is autpmaticaliy loaded, causing the 
recorded parameters to be used. 

13.2.3 PARAMETER LIST 

A parameter list, indicated by the SEMI-COLON (;) following the file specification may be 
included. That list may include up to seven parameters which are order independent. The 
possible parameters are: 

!;|margin}{tab key){modej{shift}[line}(update}{format} 

If no parameter list is provided. Assembler mode with a margin at 75 and SPACE bar for 
tabbing is assumed. 

13.2.3.1 Margin Bell 

A number in the parameter list will be taken to be the margin designator; this causes 
the margin 'bell' to ring at the designated margin. (Text may always be input up to column 
79 regardless of the margin setting.) 

For Example ;30 will cause the bell to ring in column 30. 

13.2.3.2 Tab Key Character 

A tab key character encountered in the parameter list, i.e., a non-alpha, non-numeric, 
non-colon, will replace the assumed tab key character. (SPACE in Assembler, DATABUS and 
Comment mode, SEfVU-COLON in Text mode.) 

For Example; jwill cause the tab key caret (|) to replace the assumed character. 

13.2.3.3 Mode 

A new set of assumptions will be used if one of the 'mode' parameters is set. If no 
mode is listed or A' is typed, Assembler mode will be used. DATABUS (D) mode simply 
changes the tab stops. Comment mode (C) changes the nature of the DELETE and SCRATCH 
commands to facilitate adding or changing comments on assembly code files. 

Text mode (T) sets no tabstops, does no shift inversion and enables the word wrap 
around feature (see the glossary). To activate line truncation instead of word wrap around in 
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Text mode, enter L' in the parameter list. To enable shift key inversion (see glossary) in Text 
mode, enter the parameter 'S' in the list. Text mode is especially useful for generating 
SCRIBE input files. 

See the glossary for complete definitions of the various modes. 

13.2.3.4 Update 

During editing, the source file is transferred into the scratch file as the text is updated. 
The physical source file may be used as the scratch file as the edit proceeds. When the edit 
is terminated, the physical source file is updated. 

To inhibit source file update, the 'ONE-PASS' OPTION' O' may be set ih the parameter 
list. A flag is set which prevents writing on the physical source file. Then, at the completion 
of the edit, the scratch file will contain the updated information and the source file will be 
unchanged. 

13.2.3.5 Key-click 

If the 'K' parameter is set, a click will sound each time a key is struck. 
13.2.4 EXAMPLES 

To perform standard Assembler code editing, enter the command: 

EDIT <source> 
To edit a file for input to the text processor, SCRIBE, the command: 

EDIT <source>;T 
is adequate. To change the margin bell to ring at column 35 (e.g. for labels) the command: 

EDIT < source >;35T 

would set the bell and use the Text mode assumptions. Note that the parameters are order 
independent; therefore, the command: EDIT <source>;T35 would achieve the same results. 

To generate a second, slightly different, file (without updating the original file), the 
command: 

EDIT <source>,<new file>;OT 

protects the source. If the file is Assembler code instead of text, simply omit the T'; if 
DATABUS, replace T' by 'D'. 

A second file, with the same name as <f1>but with a different extension, may be used 
by entering: 
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EDIT <f1 >,/<extension> 

Once the initial command (and parameter list) has been entered. The DOS Editor signon 
message will appear on the screen. This message will be rolled up and the screen cleared 
with the cursor left on the command line'. From this position data may be entered, lines may 
be fetched from the source file, or editor commands may be executed. 

13.2.5 DATA ENTRY 

To enter text, simply type on the bottom line, when the ENTER key is pressed the screen 
rolls up one line. The command line is once again blank and the cursor is at the beginning 
of the command line, ready to accept more input. 

If wrap around is in effect, when a SPACE is typed within the last 10 columns of the 
line or typing proceeds past the end of the line, the same action occurs. If a non-space 
character is typed into the last column, the last word on the line is removed and, after the 
screen is rolled up, that word is place on the command line, where data entry may proceed. 

When typing on a screen line" (as the result of a command), the ENTER key causes the 
cursor to return to the command line. To continue data entry at the same screen area, the 
Pseudo-ENTER key may be used. This key (DEL shifted) causes (in all but command mode), a 
new blank line to be inserted at that point on the screen so that data entry may proceed. 

If word wrap around is enabled, and data is being entered on a screen line, a new line 
will automatically be inserted at that point when, as on the bottom line, a space is entered 
within the last 10 columns or a character is typed past column 79. 

The BACKSPACE key erases the last character and moves the cursor back one position. 
The CANCEL key erases the line back to the previous tabstop (in text mode this would erase 
the entire line). 

Typing the tab key character causes the cursor to move to the next tab stop to the right. 
If there are no tab stops to the right of the cursor, the tab key character is accepted as a 
normal data character. 

13.2.6 DATA RETRIEVAL 

To fetch data from the source file, press the KEYBOARD and DISPLAY keys 
simultaneously. As long as the two keys are depressed, data will be fetched, displayed on 
the command line and rolled up the screen. If end of file is reached, no more data is fetched 
and the machine beeps. 

To fetch a single line, the DEL key may be pressed (in the first column of the command 
line). Using this key insures that only one input line will be fetched. 
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13.2.7 EDITOR COMMAND FORMAT 

The text appearing on the eleven screen lines (i.e. the lines above the command line) 
may be edited using a set of 'commands'. A 'pointer' {>) in the left hand column of the 
screen indicates the line which the command will affect. 

To move the pointer up, press the KEYBOARD key. The DISPLAY key moves the pointer 
down. The pointer wraps around from the top to the bottom and vice versa. 

Commands allow the user to delete a single line (:D) or part of the screen (:SC and 
:SB), insert {:l) a new line between the current lines on the screen and to modify parts of a 
line by replacing text or inserting new text. Commands are also available to search the file 
for specific text (:F and :L) or for the end of the file (:E0 or :E*). 

An editor command is always preceeded by a COLON (:). To enter a command, type, in 
the first column of the command line, a colon and the appropriate command character and any 
necessary parameters. The command is always typed with the machine in lower case; thus, 
with shift inversion on (as in Assembler, Databus and Comment modes), the command 
character will appear upper case; while with shift inversion off (as in Text mode), it will appear 
lower case. 

13.3 COMMANDS 

The following commands are a subset of those available. The user can get started 
without worrying about complex command forms. Remember that the 'pointer' on the screen 
indicates the line affected by the command. 

:D - DELETE - in all but Comment mode this command deletes the entire pointed line. 
(In Comment mode, only the comment field is deleted. The CANCEL key may however be 
used to delete the preceeding fields in the line.) 

The cursor is left on the now null line where new text may be entered. If no replacement text 
is needed, be sure to press the ENTER key in the first column of the pointed line, since 
trailing blanks will not generally be truncated. 

Pseudo-ENTER may be used to generate additional lines at this area of the screen. Word 
wrap around, if in effect, will apply to text entered on a deleted line. Pressing the ENTER key 
will return the cursor to the command line. 

See the section on modification for more information. 

:E*- EOF without display - searches for the end of the file and, when it is reached, 
displays the last screen of text. The search may be aborted by pressing the KEYBOARD and 
DISPLAY keys simultaneously. 

:E0 - EOF with display - causes the data to be displayed on the screen continuously 
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until end of file is reached. The display may be stopped at any time by pressing the 
KEYBOARD and DISPLAY keys. 

;F <old text>- FIND match - the screen is cleared and the input file is searched for 
a line starting with the specified x<o\a text>. Leading spaces in the input lines will be 
ignored and should not be entered as part of <old text > (note that this command should be 
typed exactly ;F< SPACE >< old text >). 

A FIND will wrap entirely around the file (or up to the end of file if the one-pass option is 
set). If the requested text is not found, the last line on the screen when the FIND was 
executed will be displayed. A FIND may be stopped by pressing the KEYBOARD and DISPLAY 
keys. 

:l - INSERT - Perform a line insert at the pointed line. This command causes the 
lines from the top of the screen to the pointed line, inclusive, to be rolled up and a blank line 
to be inserted. The cursor is left at the beginning of the new blank line where data entry may 
proceed. 

If the pointed line or the line immediately below it is empty no insert will occur, and the null 
line will be used as the inserted line where data entry may proceed 

To make complex changes to a line already on the screen, the operator may INSERT a line 
immediately below the original and then retype the line - with changes. The original line may 
then be DELETED. 

The pseudo-ENTER key may be used to generate additional blank lines at the same point on 
the screen. 

:L - LOCATE next - typed exactly :L<ENTER>, clears the screen and finds the next 
line of text. If positioned at the end of the file, the next' line will be the first line of the file. 

:L <old text>- LOCATE match - similar to FIND match except that the locate 
command searches for imbedded text matching < old text >. Leading spaces should be 

siinDli«=^H if monninnfiil 

For additional forms of the FIND and LOCATE commands see the FILE SEARCH' section. 

:M <old textxcommand separatorxnew text>- MODIFY - a modify command 
allows the operator to replace <old text > by < new text >, insert < new text > after < old 
text>or append (I.e., truncate and add) < new text>after <old text>. For the 
various forms of this command see the 'MODIFICATION' section. 

:SC - SCRATCH above - in all but Comment mode this command erases the lines 
from the top of the screen down to the pointed line, inclusive. (In Comment mode, only the 
comment fields are erased.) 

The cursor is left on the pointed line where data entry may proceed. 
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from the pointed line to the bottom of the screen, inclusive. (In Comment mode, only the 
comment fields are erased.) 

The cursor is left on the pointed line, where data entry may proceed. 

;E - END - the end command causes the remainder of the logical source file to be 
copied to the logical scratch file and then, if the logical scratch is not the physical input file, 
the scratch file is copied back to the source file. 

The command line will be left on the screen as long as the copy from source to scratch is in 
progress; it is erased during the final copy from scratch back to source. 

The end may be terminated as long as the command line is still displayed, by pressing the 
KEYBOARD and DISPLAY keys. When the final copy is completed, control is returned to the 
D.O.S. 

Note that if the one-pass option was selected in the parameter list, no copy from scratch back 
to source wilt be performed. 

:E/ - END/DEL - this command causes the r@mainder of the source file to be deleted 
(tht) lines currently on the screen will be writtin out), and, if the logical scratch file is not the 
phyHical source file, the scratch file is copied back to the source file. When the file is 
completely updated, the system is reloaded. 

No copy back is done if the one-pass option is set. 

13.4 MODIFICATION COMMANDS 

13.4.1 DELETE COMMAND 

Modification of a line may be achieved In a variety of ways. The DELETE command 
enables the user to remove leading information while the MODIFY command may be used to 
replace imbedded information, insert text into a line or field, or truncate and add new text at a 
specified point or in a specified field. 

:D <old text>- DELETE through - this command deletes all character from the left 
edge of the pointed line through (and including) the specified <old text>. The remaining 
characters will be left justified and re-displayed. The cursor returns automatically to the 
command Ime. 

13.4.2 MODIFY COMMAND 

The general form of the MODIFY command is: 
:M(#}{old text} <sep> {new text) 
where {#}is a number which extends the meaning of the command and <sep>is the 
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tened. 



command separator which defines the action of the command. Both {old text}and {new 
textjfields are optional. If {old textjis omitted, the command will take effect at the 
left most edge of the pointed line (or at the left edge of the specified field). If the {new 
textjfield is omitted, a null field will be used to execute the modification. 

13.4.2.1 LINE MODIFICATION 

The following descriptions are of the line modification version of the MODIFY command 

:M {old text} < {new text}- MODIFY (replace) - replace the specified {old text}by the 
specified {new text}. The less than character (<) is a command separator which indicates 
replacement and, therefore, the {old text}may not contain this character. If {new text}field is 
omitted, the old text will simply be deleted and the line will be compressed to the left. 

For example to modify the text line: 

THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG'S BACK. 

The command: :M BROWN < RED would cause the line to be redisplayed like this: 

THE QUICK RED FOX JUMPED OVER THE LAZY DOG'S BACK. 

The e ocommand: :M .<1234 TIMES, to the original line would generate a line like: 

THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG'S BACK 1234 TIMES. 

If the replacement causes the line to become longer than 79 characters, the trailing word, in 
text mode only, will be wrapped around and a new line will be inserted containing the entire 
LMLAST WORD, If the {new text)is shorter than the {old text}it replaces, the line will be shor- 

After the pointed line is redisplayed, the cursor is returned to the comrrand line. 

:M {old text} > {new text}- MODIFY (insert) - the command separator greater than (>) 
causes the {new text}to be inserted in the pointed line immediately after the {old text}. 

If the line becomes longer than 79 character, and word wrap around is not in effect, the 
trailing characters are truncated. If, however, word wrap around is on, the trailing character 
and last word are inserted on a new line. 

:M {old text} {new text}or 

:M {old text) {new text}- MODIFY (append) - the vertical bar ( 

by the {new text}. 

As in all MODIFY commands, if the pointed line becomes longer than 79 characters, truncation 
occurs if word wrap around is not implemented. 

:M{#}- MODIFY repeat - typed exactly :M<ENTER>, uses the <old 



13-8 PART III SYSTEM COMMANDS 



textxsepxnew text>from the last MODIFY 

command. This is useful when making the same change repeatedly. Note that the field 

number is not saved, and must, therefore, be supplied if necessary. 

:M*- MODIFY display - display the expression entered for the last MODIFY After the 
saved command is displayed, the cursor is turned off and the operator must press ENTER to 
proceed. No MODIFY is actually performed. 

13.4.2.2 FIELD MODIFICATION 

In field modification mode, the MODIFY command acts only on a specific field and does 
not expand or contract the entire line but maintains the integrity of all fields before and after 
the affected field. 

:M<#>{old text} <sep> {new text}- MODIFY field - where the pound sign <#>is a 
number from 1 to 6 designating the field to be modified (or the starting point to search for 
matching {old text}). Field 1 is always the left hand margin, thus, in Assembler mode, field 1 
IS the label, field 2 is the op code, field 3 is the expression and field 4 is the comment. This 
command may be executed in any of the previous Modify forms. However, modification is 
performed within the specified field only. As long as the text being modified is unique, field 1 
may be specified, since the field number indicates only where to start looking for matching 
text. (Note that if the field number is omitted, line modification is assumed.) 

Thus, a replacement or append shorter than the original field will be blank filled and 
subsequent fields wHI maintain their position and content. An insertion longer than the 
specified field will be truncated (with the exception of the last field whenever word wrap 
around is in effect). 

For example, in Assembler mode, the line: 



LABEL OP EXP COMMENT 

+FC4'# 

the label may be deleted by the command: 

:M1 

with the resultant line: 



OP EXP COMMENT 

+ FC4'# 

Or, the expression field (EXP) could be changed to EXP+1 without disturbing the comment 
field position, by the command: 

:M3 EXP> + 1 
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which generates: 



LABEL OP EXP+1 COMMENT 

ffC4# 

Note that in the above example, :M1 EXP would also have worked, since EXP occurs only in 
the third tab field. 

To add a comment to a line previously containing none or to replace an existing comment 
field, enter: 

:M4 

NOTE: Remember when using the repetitious form of the MODIFY command that the 
field number must be supplied. 

13.5 FILE SEARCH COMMANDS 

The FIND and LOCATE commands have several forms and have been separated from the 
basic command set to better describe them. 

Manual, operator controlled, searches may be performed by depressing the KEYBOARD 
and DISPLAY keys simultaneously to cause data to be fetched from the file and displayed (as 
long as the keys are pressed) on the screen. To fetch a single line use the Pseudo-ENTER 
key (DEL shifted). The :E0 command performs the same function automatically, i.e., it causes 
lines to be fetched and displayed until the end of file is reached. To terminate a :E0 
command, press the KEYBOARD and DISPLAY keys. 

To find the end of a file, without displaying the entire file (since the display is time 
consuming) use the :E*command. This will search for the end of file and display the last 
eleven lines of data. 

:F <old text>- FIND match - the screen is cleared and the input file is searched for 
a line starting with the specified <old text>. Leading spaces in the input lines wiU be 
ignored and should not be entered as part of <old text>(note that this command should be 
typed exactly :F<SPACE><old text>). 

A FIND will wrap entirely around the file (or up to the end of file if the one-pass option is 
set). If the requested text is not found, the last line on the screen when the FIND was 
executed will be displayed. A FIND may be stopped by pressing the KEYBOARD and DISPLAY 
keys. 

The <old text > specified for a FIND (or locate) command is saved. The saved match may be 
redisplayed or used again. 

:F< SPACE > - FIND same match - if the FIND command is followed by exactly one 
space and the ENTER key, the previous FIND (or LOCATE) <old text>will be used for this 
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FIND. In this manner, several occurrences of the same text may be searched for. 

:F*- FIND display - the asterisk (♦) after the FIND command causes the <old text>of 
the previous FIND or LOCATE command to be displayed. The cursor is turned off and the 
operator must press ENTER to proceed. No FIND is performed. 

:L - LOCATE next - typed exactly :L< ENTER >, clears the screen and finds the next 
line of text. If positioned the end of the file, the 'next' line will be the first line of the file. 

L <old text>. LOCATE match - similar to FIND match except that the locate 
command searches for imbedded text matching <old text>. Leading spaces should be 
supplied if meaningful. 

:L<space> - LOCATE same match - typed exactly :L< SPACE >< ENTER >, uses the 
<old text > specified by either the previous LOCATE or FIND command to perform a search 

:L*- LOCATE display - display the <old text > entered for the previous LOCATE or 
FIND command. As in the FIND display, the cursor is turned off and the operator must press 
ENTER to continue. No LOCATE is actually performed. 

13.6 MISCELLANEOUS COMMANDS 



:B - BYPASS - fetch a line from the file, bypassing end of file or record format error 
(which would normally be treated as an end of file). Subsequent lines (if not 
also record format errors) may then be fetched by the normal mechanisms. This 
command is intended as a recovery tool for use only if the file has been 
accidentally shortened or contains badly formatted records. 

:C - COPY - copies the pointed line to the bottom of the screen, deletes the pointed 
line and rolls the screen up one line. This command cannot be executed on 
the top screen line. 

The cursor is left on the now null pointed line. Text may be entered at this 
point (the Pseudo-ENTER and word wrap around, if In effect, will apply). When 
the ENTER key is finally pressed, the pointer is automatically moved to the 
following screen line so that a group of lines may be easily copied to another 
part of the screen. 

:T - TAB set - this command enables the user to reset the tab stops during execution. 
(Not available in Comment mode.) The command causes a line of numbers to 
be displayed across the bottom of the screen. 

The operator should space over to each position where a tabstop is desired and 
type any non-blank character. These tab stops are meaningful during data entry 
and field modification (:M#) since data within a field may be modified without 
disturbing the rest of the line. A maximum of 10 tab stops may be set. 
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:RH - RPG Header - sets tab stops for RPG header specification at columns 6 and 15. 

RF - RPG File - sets tab stops for RPG file description specification at columns 6, 
15, 24, 33, 40, 54, 66 and 70. 

:RE - RPG Extension - sets tab stops for RPG extension specification at columns 6, 
11, 19, 27, 33, 36, 40, 46, 52 and 58. 

:RL - RPG Line - sets tab stops for RPG line counter specification at columns 6, 15 
and 20. 

:RI - RPG Input - sets tab stops for RPG input specification at columns 6, 15, 21, 44, 
53, 59 and 65. 

:RC - RPG Calculation - sets tab stops for RPG calculation specification at columns 
6, 18, 28, 33, 43, 49, 54 and 60. 

:R0 - RPG Output - sets tab stops for RPG output specification at columns 6, 15, 23, 
32, 38, 40 and 45. 

:RS - RPG Summary - sets tab stops for RPG summary specification at columns 6, 14 
and 23. 

:X - TEXT - this command implements word wrap around and disables shift key 

inversion and space insertion after leading periods. It automatically enters the 
tab set command (:T), so that tab stops may be cleared by the operator. The 
tab key character is not changed; therefore, the :<tab key>command must be 
used to set a new tab key character if one is desired. 

:<tab key>- change tab key character to any non-alpha, non-numeric, non-COLON. 
non-ENTER character typed after a leading colon on the command line. 



13.7 HtCOVERY PROCEDURES 

A FORf^AT TRAP' occurs when a record not belonging to the current file is 
encounter'ed. This can be caused either by a physical misalignment of the disk read head or 
because a record has erroneously been written into that file by some other program. 

A 'RANGE TRAP' occurs when the physical limit of the file is reached and no end of 
file is present. 

13.7.1 Bypassing Errors or End of File 

When a format or range error occurs, an appropriate message appears on the 
command line and the cursor is turned off. In order to proceed, the operator must first press 
the DISPLAY key. The effect of either a format or range trap is the same as an end of file 
and no further data will be read from the file. 
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To read past a format error or past an end of file, use the BYPASS command, :B, 
repeatedly if necessary. 

13.7.2 File Recovery 

If the source file is lost (e.g., erroneously KILLed), the scratch file may contain a useful 
copy. The scratch file (SCRATCH/TXT) contains a copy of the last file edited, It may be used 
to recover only that file. 

13.8 GLOSSARY 

Assembler mode - assumed mode of execution. Tab stops at 9, 15 and 30 (may be changed 
during execution). The space bar is assumed as the tab key character (this 
may be changed in parameter list or during execution). Shift key inversion and 
no word wrap around are assumed. Leading period (.) generates period space 
(. ) for comment lines. Pseudo-ENTER does line-insert. 

Command - characters typed at the left edge of the command line following a COLON (:) 
which have special meaning to the editor. 

Command line - the twelfth line of the screen where most data is entered, lines are fetched 
and commands are typed. 

Command separator - the character in a MODIFY command which indicates what is to be 

done (> means insert, <means replace and or mean append). 

Comment field - in assembler code the area of the screen from columns 30 to 79 is generally 
used for programmer comments. 

Comment mode - executed if 'C in parameter list. Facilitates changing or adding comments 
to assembler code. Tab stops at 9. 15 and 30 (may not be changed during 
execution). The space bar is assumed to be the tab key character (this may be 
changed in parameter list or during execution). Shift key inversion and no word 
wrap around are assumed. Leading period (.) generates period space (. ) for 
comment lines. Pseudo-ENTER positions to comment field of following line and 
deletes the comment. Delete and Scratch commands affect only the comment 
field. Trailing blanks are truncated when data is output. 

DATABUS mode - executed if 'D' in parameter list. Tab stops at 9 and 15 (may be changed 
during execution). The space bar is assumed to be the tab key character (this 
may be changed in the parameter list or during execution). Shift key inversion 
and no word wrap around are assumed. Leading period (.) generates period 
space (. ) for comment lines. Pseudo-ENTER does line-insert. Input lines are 
blank filled and trailing blanks are truncated on output. 

Field number - a digit used in the MODIFY command to designate characters between two 
tab stops. Field '1' is always from column 1 to the first tabstop; thus, in 
Assembler mode, V designates the label field, '2' the opcode field, '3' the 
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expression field and '4' the comment field. During field modification, trailing 
fields are preserved. 

Format trap - bad record encountered on disk. See 'RECOVERY PROCEDURES', subsection 
13.7. 

Line insert - results from an INSERT command, data entry or modification when word wrap 
around is in effect or a Pseudo-ENTER key in any mode other than Comment. 
The lines above the pointed line are rolled up and a new, blank line is 
geherated at the pointed line. 

Logical scratch file - current output file. 

Logical source file - current input file. 

New text - a group of characters, typed immediately after a command separator in a modify 
command, which will become part of the line being modified. 

Old text - a group of characters, including spaces, which are searched for, either in the 
pointed line (as in the MODIFY command) or in the file (as in the FIND or 
LOCATE commands) 

One-pass option - a flag may be set in the parameter list which inhibits updating of the 

original source file. The FIND, LOCATE and END, END/DEL commands will not 
write back into the input file if this option is set. 

Parameter list - initialization information provided when the editor is first executed. Following 
file specifications, a SEf^l-COLON (;) indicates the presence of a parameter list. 
The mode, one-pass option, tab character, margin bell column and (in text 
mode) no shift inversion' (S) and 'no word wrap around' (L) may be set. 

Pointed line - a pointer (>) in the left hand margin is used to reference lines for 

modification by command. The line to the right of the pointer is the pointed 



Physical scratch file - specified (or implied SCRATCH/TXT) output ?ile. 

Physical source file - specified input file . 

Pseudo-ENTER - the key marked DEL (always shifted) is referred to as the Pseudo-ENTER 

key. If pressed in the first column of the command line, one line of text will be 
fetched from the source file. 

In comment mode, if pressed on any but the bottom screen line or command 
line, it will cause the cursor to be positioned to the comment field of the 
following line and that field will be erased. 

In all other modes, the Pseudo-ENTER key causes a new line to be inserted so 
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that data entry may proceed in the same area of the screen. If pressed on the 
last screen line, the Pseudo-ENTER key simply places the cursor on the 
command line. 

Range trap - attempt to read or write past allocated space on disk - see 'RECOVER 
PROCEDURES' in subsection 13.7. 

Scratch file - at any point in time, the logical scratch file is the output file. It may, however, 
physically be the original input or the assigned 'scratch' file. 

Screen line - any of the eleven lines on the screen which may be referenced by the 
command pointer. The command line is not, therefore, included. 

Shift key inversion - reverse the function of the shift key for all alpha characters so that, in 
lower case, alpha characters will appear upper case. 

Source file ^ originally this is the Input file specified at initial execution. The term source 

file refers to the current input file; thus, at any point in time, the logical source 
file may be either the specified input file or the file specified as the scratch file. 

Text mode - executed by a T' in the parameter list. No tab stops are set (tabs may be set 
during execution). The SEMI-COLON (;) is the assumed tab character (the tab 
key character may be changed in the parameter list or during execution). No 
shift key inversion is performed (this may be selected in the parameter list). 
Word wrap around is performed (this feature may be turned off by an 'L' in the 
parameter list). 

Word - a word is defined as any group of less than 50 characters preceeded by a space. 

Word wrap around - a feature of text mode. During data entry a space within the last 10 

columns of the screen cause an immediate carriage return. If this occurs on a 
screen line, a line insert is performed so that data entry may proceed at the 
same area of the screen. If a character is typed over the last column of the 
screen, the last word is removed, a line insert performed and the removed word 
is placed at the beginning of the inserted line where data entry may proceed. 
If a modify command causes the line to become longer than 79 characters, the 
trailing characters, including the last word on the line, will be moved to a new 
line which will be inserted below the original line. Control will then return to 
the command line. 

Write edit format - A DATABUS compatible cassette format selected in the parameter list. 

This tape format creates one 80-character tape record per screen line. Spaces 
are not compressed and trailing spaces are supplied to fill the line out to 80 
characters. 
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13.9 COMMAND LIST 



:B 
:C 
:D 

D <old text> 
:E 
:E0 
:E/ 
:E* 

:F <old text> 
:F<SPACE> 
:F* 
;l 
;L 

:L <old text> 
:L<SPACE> 
:L* 



BYPASS end of file 

COPY pointed line to command line ana roll up 

DELETE entire line 

DELETE from left thru <old text> 

END edit - copy remainder of file and update source 

EOF display - fetch and display data until end of file 

END/DELETE update without copying remainder 

EOF search - find end of file and display last full screen 

FIND match - search file for matching leading text 

FIND repeat - use previous find/locate <old text> 

FIND display - display previous find/locate <old tsxt> 

INSERT a blank line below pointed line 

LOCATE next - clear screen and get next line 

LOCATE match - search file for matching imbedded text 

LOCATE repeat - user previous find/locate <o!d text> 

LOCATE display - display previous find/locate <o!d text> 

LINE MODIFICATION 
:M {old text}<jnew text}- MODIFY replace old text by new text, adjusting the entire line 
:M {old text} > {new text}- MODIFY insert new text after old text, adjusting the entire line 
:M 'old text) old text adjusting the entire line 
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FIELD MODIFICATION 

:M<#>{old text} < {new text}- field MODIFY replaces old text within specified field with new 
text without disturbing the remainder of the line. 

:M<#>|old text} > {new text}- field MODIFY inserts old text after new text within specified 
field, without disturbing the remainder of the line. 

:M<#>{o!d text} the new text after the old text within the speci! 

disturbing the remainder of the line. 



;M* MODIFY displays the previous modify {old}<sep>{new} 

:M{#} MODIFY repeats the previous modify {old}<sep>{new} 

:SB SCRATCH BELOW deletes the pointed line and all screen lines below it 

:SC SCRATCH ABOVE deletes the pointed line and all screen lines above it 

:T TAB SET permits the user to set up to five tab stops 

:X TEXT mode (DOS only) switches to text mode with word wrap around 
and no shift key inversion. 

:< character, > \ changes the tab key character to < character >. 
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SECTION 14. FILES COMMAND 



FILES is a program which selectively prints or displays DOS file descriptions in file 
name sequence. 

The user may select Information pertaining to ail DOS files or only those files with 
names ^nd/or name extensions beginning with the characters specified by the operator. 
Selected directory entries are sorted into ascending file name sequence. If desired, information 
from associated Retrieval Information Blocks is also extracted for each Directory entry. 
Extracted data is interpreted and displayed on the CRT or listed on a Local or Servo printer. 

Program execution is initiated by the operator typing in the name FILES followed by 
selection criteria and display options (if option codes are to be used). 



COMMAND DESCRIPTION: (Parameters in brackets are optional) 



FILES {file-nm}{/file-extH:DRn},{<subdJr-nm> 
( , < output-file > } { ;options} 



file-name: 



Select entries for files with names t>eginning with the 1-8 characters 
specified. 



file-ext: 



Select entries for files with name extensions starting with the 1-3 
characters specified. This criterion must be preceded by a slash. 



DRn: 



Specifies the disk drive to be selected. This criterion must be 
preceded by a colon. If this criterion is omitted, drive will be 
selected. 



options: 



The following option codes must be preceded by a semi-colon but 
may be entered in any order: 



N - Suppress file allocation map. 
D - Display on CRT. 
L - List on local printer. 
S - List on servo printer. 
F - Write output to disk as DOS text-type 
file. 

If options are keyed and D, L, S are omitted, then D is assumed. If <output file speois 
not present in the command line, one is requested by the message: 
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DOS OUTPUT FILE SPEC: 



DEFAULT MESSAGES 



If no option codes are entered, the following messages will be displayed on the CRT: 

SUPPRESS FILE ALLOCATION MAP? 

If 'Y' or 'YES' is entered in response to this message, the display of file allocation 
information from Retrieval Information Blocks (RIB) will be suppressed. If any other response 
IS entered, file allocation information will be displayed for each selected file. 

After the user has replied to the map selection message, the program will test to see if 
there is a servo printer connected to the processor that is ready for printing. If a servo 
printer is attached and ready, the following message will be displayed: 

LIST ON SERVO PRINTER? 

If the user enters a 'Y' or 'YES' in response to this message, the servo printer will be 
selected to display output. If any other response is entered or the program cannot find an 
available servo printer, the program will test to see if a local printer is connected and ready 
for printing. If the program finds that a local printer is available, the following message will 
be displayed: 

LIST ON LOCAL PRINTER? 

If the user enters 'Y' or 'YES' in response to this message, the local printer will be 
selected for output. 

If the program cannot find an available printer, or the operator fails to select a printer 
with an option code or in response to a message, the program will display file descriptions 

If a printer has been selected for output, the following message will be displayed: 

ENTER HEADING: 

Up to 32 characters can be entered that will be displayed at the top of each page of 
listed output. 

File descriptions are sorted into ascending file name sequence for easy reference and 
displayed or printed in the following format: 

FILENAME/EXT (PFN) DW 
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DW lags following the Physical File Number (PFN) indicate if the file is delete 
protected (D), or write protected (W). If the file allocation map was not suppressed disk 
dependent messages describing the file's size and location will be included in the file 
description. 

Depressing the DISPLAY key during display or printing of file descriptions will cause 
the program to pause until the key is released. Depressing the KEYBOARD key will cause 
the program to terminate and return control to the operating system. 

if FILES detects any abnormalities during program execution, an error message will be 
displayed on the CRT followed by a BEEP. 



ERROR MESSAGES 

♦PARITY ERROR * 

FILES can not continue due to an irrecoverable parity error encountered while trying to read 
data from the disk. 

•DRIVE OFFLINE * 

FILES is unable to connect to the disk drive selected by operator (drive if not otherwise 
specified). 

FILECS) NOT FOUND. 
No Directory entries have been found that meet the users selection criteria. 

INVALID DRIVE 
The user has entered data preceded by a colon that Is not a valid disk drive. 

CONFLICTING OPTIONS SPECIFIED 
Options specify output on more than one device. 

UNRECOGNIZABLE OPTION CODE 
An unrecognizable code has been entered in the option field. 

PRINTER NOT AVAILABLE 
An option code specifies a printer that does not respond when tested for status. 
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SECTION 15. FIX COMMAND 



FIX <file speo 

This will cause a set of five zeros two spaces and three more zeros to be displayed on the 
bottom line. (The zeros represent the current address and its contents.) 

00000 000 

The screen is then rolled up. The program is waiting for a command from the operator. 

Commands are in the form {number} {characterjwhere the number is assumed to be octal. If 
the number is omitted, a value of zero is used. 

The following is a list of command characters with their effect: 

ENTER - If no block of object code is currently in 

KEY memory (as at the beginning or after a block has been rewritten), search the 

object file forward until a block containing the given location is found, then 

display the contents of that location. 

- If a block of code is in memory and the location given is within the limits of the 

block, the contents of the location will be displayed. 

- If a block is in memory and the location given is not within the block limits, the 

current address will be set to the minimum or maximum address of that block, 
its contents will be displayed and a beep will sound. 

M - Change the contents of the displayed address to the number given. 

1 - Increment the current address (up to the maximum address in the current block). 

- Change contents of displayed address to number given and automatically 

increment the current address and display the contents of that location. 

D - Decrement the current address (down to the minimum address in the current 

block). 

T - Transfer the modified block back to disk - rewritting it in place. After the block 

is written, the current address is set back to zero, so that all searches always 
start from the beginning of the file. 

A - Abort processing the current block, set the current address back to zero. 

O - Return to the operating system - if there is a block of object code in memory, it 
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is not written back into the file. 

If the command character is not one of the above, it is ignored and regarded as if only 
the ENTER KEY had been pressed. If the <filespec>is not an ABS file, the message 

RECORD FORMAT ERROR 

is displayed. If the <filespec>is not on an online pack or have the correct extension, the 
message 

NO SUCH NAME 

is displayed. 
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SECTION 16. FREE COMMAND 



FREE - Free space display command 

16.0 PURPOSE 

The DOS supports 256 files per logical drive. This limit is dictated by the use of a 
single 8-bit quantity for the storage of the physical file number, which must uniquely identify 
any file on a given logical drive. 

As a disk becomes fuH, it is frequently useful to know how many 256-byte sectors 
remain available for allocation. Another useful bit of knowledge on the larger disks is how 
many empty slots in the directory remain for the allocation of file names. This is precisely 
the function of the FREE command. 

16.1 USE 

The FREE command accepts no operands. It is entered simply as: 
FREE 

The command scans all drives that it finds on-line and displays (1) the number of 
available file names (representing possible files to be created) and (2) the number of 
available 256-byte sectors that it finds on each. 
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SECTION 17. INDEX COMMAND 



17.1 INTRODUCTION 

The DOS INDEX command is used to create the tree structure required by programs 
using the indexed sequential access method (ISAM). 

The INDEX command has the capability of creating index files from any DOS text-type 
files. The indexed access method can then rapidly access records in this file either in 
sequential or random order. Records in files to be indexed must contain a single record key 
up to 100 characters long contained in the first 249 bytes of each record. 

The format of the key is mmm-nnn where mmm is the beginning character position of 
the key field in each logical record and nnn is the ending position of the key field. It is 
required that the second key specification (nnn) be greater than the first specification 
(mmm).Note that each record must have a unique key. 

It is possible to build many independent indices to permit access to records of the 
same file by many separate, unrelated keys. There are no restrictions on the number of 
indices that may be built, or on the relationship or lack of relationship among the various 
keys used. 

As a special option, INDEX will generate Index files keyed by the EBCDIC collating 
sequence. Default collating sequence Is ASCII. If EBCDIC sequence is required, version 3 
of Sort is required. If only ASCII sequence is to be used, version 2 or later may be used. 

17.2 SYSTEM REQUIREMENTS 

INDEX runs under the DOS operating system and requires a DOS-supported direct 
access device. In addition, INDEX uses the DOS SORT command, which must be resident on 
an online disk at the time INDEX is used. If the index command is to pre-process the text 
file, the REFORMAT command must be available. (See 17.5 PREPROCESSING). 

17.3 OPERATION 

When the Index command is to be executed, the operator must enter: 

INDEX <file-spec>{,<file-spec>};<parameters> 

where only the first file specification and key field description are mandatory, and specify the 
file to be indexed. Default extension is /TXT. The second file specification is the name of 
the INDEX file to be created. If no file is specified, the name of the first file is used with 
default extension /ISI. Note that INDEX files may have any names at all - and be located on 
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physically different drives from the file being indexed. 

17.3.1 PARAMETERS 

In addition to the parameters that INDEX itself recognizes, the user may specify any 
parameters acceptable to the REFORMAT utility (if preprocessing is to be done) or a primary 
record specification to be passed to SORT. Parameters recognized by INDEX are as 
follows: 

F -- Preprocess the input file 

p -- Display the SORT and REFORMAT parameters 

(Note that this is a lower case 'p') 
E -- Index in EBCDIC collating sequence. 

The primary record specification is an option that allows the user to create the ISAM 
index file from a subset of the data file. The format of the primary record specification is 
PnnnfC. The P must always appear. The field following P, denoted by nnn, represents the 
place in each logical record where a one position field exists that differentiates records in 
the file. The location of this one character field must be less than or equal to 249. The 
caret (I) can have one of two values. It can be either an equal sign (=) or a pound sign 
{#). If the former, it means create the ISAM index file from all records that 
contain the ASCII character C in position nnn. If it is a pound sign, it means that the 
ISAM file will be created from all records that do not contain the value of C in position nnn. 

In general the parameters for INDEX can be specified in any order and may optionally 
be separated from each other by one or more blanks. The only exception to this is when a 
primary record specification exists, it must precede the key field specification and be 
separated from the key by a blank or a comma. 

17.4 CHOOSING A RECORD KEY 

Since the speed of access to an indexed file varies according to how much file space 
and thus how many levels of index are required for the index tree, the choice of what to use 
for a record key becomes highly important. Of course, you must choose a key which will 
uniquely determine the record you wish to access, but you should scrupulously avoid 
including information in the key which is not absolutely necessary. For example, a file could 
be keyed according to automobile license plate numbers. Typically, these numbers will 
include a hyphen or other punctuation, which could easily be excluded from the records key. 
The indexed access method will perform more efficiently if all non-significant characters are 
removed from the record's key. 

17.5 PREPROCESSING THE FILE 

In file structures such as an indexed file where records are randomly inserted and 
deleted, the file tends to become non-optimum for searching. In addition, due to the method 
with which the indexed access method inserts records, each inserted record exists in a 
separate disk sector. This means that for records tfiat are 80 characters long, two-thirds of 
the disk space for each additional record is wasted. This results in a reduction of the 
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performance of the indexed access method. 

In order to reclaim space vacated by deleted records and padding bytes in inserted 
records, the file may be processed by the REFORMAT utility prior to indexing. It should be 
noted that if any deletions have been performed since the data file was created or last 
reformattted, the file musi be reformatted before indexing. If this is not done, one or more of 
the records in the file will be incorrectly indexing making them inaccessible via ISAM 
access.dn some cases wehre this is a problem, the error message 'DUPLICATE KEY..' may 
occur. If only one record has been deleted prior to INDEXing, a duplicate key error message 
will usually not be issued, but the resulting index will generally incorrectly index one of the 
records in the data file! if there is any doubt as to whether or not records have been 
deleted, specify reformatting for the data file. 

17.5.1 INVOKING REFORMAT 

The INDEX utility will automatically invoke REFORMAT if the 'F' option is present when 
INDEX is invoked. You must have specified the options that REFORMAT will need to 
process the file. 

Note that if multiple indices are to be created, reformatting need only be specified for 
the first INDEX step, and MUST not be specified later if it was not specified in the first step. 
Although REFORMAT will not destroy the file, specifying reformatting will invalidate any 
previously built indices. 

Basically, you must tell REFORMAT what format the records of the file are to have 
after reprocessing. You may select record compression, space and record compression, or 
blocking. For additional details on the REFORMAT utility, see the REFORMAT section of this 
guide. 

17.5.2 SPECIAL CONSIDERATIONS FOR UNATTENDED INDEXING 

Users who use the INDEX command from a CHAIN file (see the section on the CHAIN 
command for more details) and used AUTOKEY to restart their chain in the even of a failure 
should generally avoid using REFORMAT directly from INDEX. The reason why is that 
REFORMAT as invoked by INDEX uses the REFORMAT-in-place mode of the REFORMAT 
command. (The reason for this is that it is faster to do so, and also allows the indexing 
with reformatting of a file which is too big to REFORMAT in the available scratch space on 
a single-drive, almost full disk). Although REFORMAT is very careful not to damage the file 
being processed, if the file is actually in the process of being reformatted when a power 
failure occurs, the results can be undesirable. 

This potential problem during unattended INDEX chaining can be avoided by setting a 
checkpoint (see the AUTOKEY command description for details), copying the original file to a 
scratch file, setting another checkpoint, reformattting the scratch file back into the original 
(using the COPY mode of REFORMAT), setting a further checkpoint, and finally INDEXing the 
file using INDEX. In this way there is always an undamaged file with which execution can 
resume if necessary. 
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17.6 INDEX MESSAGES 

The INDEX command produces several messages on the operator's console. The 
content and meaning of these messages follow: 



INDEX VERSION n.n 

This identifies the program and current version. 

FILE PREPROCESSING WILL BE DONE BY REFORMAT COMMAND 

This message indicates that the user has requested preprocessing of his file 
by the REFORMAT command. 

COMMAND STRING ERROR - TERMINATOR MISSING 
This is an internal error - report to DATAPOINT. 

INDEX/OV1 IS MISSING 

The second INDEX overlay is not on disk and should be loaded. 

REFORMAT/CMD IS MISSING 

The user has requested preprocessing, but the REFORMAT command is not 
present on disk. You must load it. 

INDEX PARM — > 

This is the parameter string that will be passed to the INDEX overlay and 
used to build the index file. 

REFORMAT PARM — > 

This is the parameter list passed to the REFORMAT command. 

INFILE NAME MISSING 

This indicates that you have omitted the first, and mandatory file 
specification. Put it there. 

KEY SPECIFICATION MISSING 

You have not given index information on the location of the key in the 
record. 

TOO MANY DIGITS IN KEY SPECIFICATION 

The key field must be no more than 6 digits long. 

ERROR IN FIRST COLUMN OF KEY 

The first key field specification is invalid. 
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KEY SPECIFICATION NOT TERMINATED BY 015 

The key field specification must be the last field in the parameter string. 

SORT MUST BE PRESENT 

INDEX has discovered that the SORT command is not resident. It must be 
loaded. 

KEY TOO LONG 

The key is over 100 characters in length, 

INFILE DISAPPEARED AFTER SORT 

This is an internal error - notify DATAPOINT. 

TAG FILE NOT GENERATED BY SORT 

This is an internal error - notify DATAPOINT. 

ILLEGAL CHARACTER IN KEY: XXX 

The character whose octal form is displayed was found in a record key. 
Only ASCI! text characters are permitted. 

DIGIT PRECEDING PRIMARY FIELD SPECIFICATION 

INDEX has found a digit where it doesn't belong - remove it. 

PRIMARY SPECIFICATION INVALID 

The Primary record specification passed to SORT has invalid syntax. 

INVALID TAG RECORD - SOFTWARE OR DISK ERROR 

The tag file has an invalid record. Possible hardware fault, notify 
DATAPOINT. 

MORE THAN ONE RECORD HAS THE KEY: key 

Duplicate keys exist in the file to be indexed. The offending key field is 
displayed. 

INDEX WILL USE EBCDIC SORT 

The user has requested an index using the EBCDIC collating sequence. 

LAST COLUMN OF KEY LESS THAN FIRST COLUMN OF KEY 

The first key field specification must be less than the second specification 

17.7 ISi FILE FORMATS 

The DOS indexed file structure consists of a multi-level radix tree structure based on 
the record keys, and contains pointers to the location of the keyed records. Note that since 
many of these pointers are physical disk addresses, the ISI file cannot be moved without 
re-mvoking INDEX. The text file may be moved so long as it is unchanged in any way. 
Moving the ISI file will destroy it. 
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The different levels of indices all have the same content, except for the lowest level 
index. Index levels are built up until the highest level of index will fit in a single disk 
sector. This requirement is the reason for the 100 character limitation on key length. 

The ISI files have the following format: 



Offset Length 
000 003 
003 Onn 



Description 

PFN and LRN bytes as per DOS convention - see DOS 

Advanced Programmer's Guide (Part IV). 
This is a KEY entry where nn is key !ength+7 for a lowest 

level index, and key length+3 for a higher level index. The 

first sector of an ISI file after the RIBs is a special header 

record. 

Note that as many key entries are put in a sector as will fit. 



Each KEY entry for a higher level index has the following format: 



Offset Length 



Description 



000 KEYLEN The highest key in the next lower level index sector. 

KL 001 Octal 012 - This indicates the end of the key and that this is 

a higher level index entry. 
KL+1 002 Sector and Cylinder of the entry in the next lower level of 

index. 
KL+3 001 Octal 0377 - This indicates that this is me last entry in this 

sector. 

Each KEY entry for a lowest level index entry has the following format: 



Offset Length 



Description 



000 KEYLEN The key for this particular record. 

KL 001 Octal 015 - This indicates that this Is a lowest level index 

entry and delimits the end of the key. 
KL+1 003 Buffer Offset, address for the logically next lowest level index 

entry. 
KL+4 003 Buffer Offset, and logical record number of the text file 

record having this key. 
KL+7 001 Octal 0377 - Indicates that this is the end of the lowest level 

index. 

The first data sector in an ISI file is a header record used to locate the file from which 
the index was built. In this way, it is only necessary to specify the name of the index to 
DATASHARE 



Otisol L«>ngth 



Description 
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003 


013 


016 


003 


021 


003 


024 


002 


026 


001 


027 


003 


032 


003 



000 003 PFN and LRN indicators as per DOS convention. See DOS 

Advanced Programmer's Guide (Part IV). 

Name of the data file that goes with this index file. 

PFN, RIB sector, and RIB cylinder of this file. This field is 
used to check that the index file has not been moved. 

PFN, RIB sector, and RIB cylinder of the file indexed. 

Offset, in bytes, of the start of the key in the indexed file. 

Length of the key in this index. 

Buffer address and LRN of the last record used in the data 
file. 

Buffer address and LRN of the first free index entry. 



17.8 EXAMPLES OF THE USE OF INDEX 

First, a simple example in which only a single ISI file is created, with the same name 
and on the same device as the text file it indexes. The file is a list of bad checks presented 
at a local grocery chain, and now each store has a DATASHARE terminal to inquire on the 
current status of each deadbeat. Thus, while the file is accessed often, additions and 
deletions are fairly infrequent, so the file will not be reformatted. The file is keyed by bank 
number (8 digits) and account number (7 digits) concatenated and in positions 1 to 15 of 
each record. 

In order to create (or recreate) the index file, the operator must type: 

INDEX DEADBEAT;1-15 

The INDEX program will then create a file DEADBEAT/ISI which DATASHARE can use 
to access the DEADBEAT/TXT file. 

Now, this same grocery chain has expanded its operations, so it desires to include 
more information on the location and date of each NSF check presented. Therefore, they 
have expanded the file to include the old key in positions 1 to 15, a store location number in 
positions 16 to 18, and a date field in positions 19 to 24. As an afterthought, the manager 
decides to tack on the name of the person passing the bad check in positions 193 to 216. 

In order to create the indices required for access by any of these keys, the operator 
must type: 

INDEX DEADBEAT,BANK;1-15 
INDEX DEADBEAT,DATE;19-24 
INDEX DEADBEAT,STORE;16-18 
INDEX DEADBEAT,NAME;193-216 

The INDEX program will create four files with names BANK/ISI, DATE/ISI, STORE/ISI, 
and NAME/ISI. Each file is logically separate, yet all are on the same volume as 
DEADBEAT/TXT. 
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Now the store owners have uncovered a hitch - first, the number of bad checks is 
becoming so large, there is no room on one disk for all the index files and the text file. In 
addition, access has 'been slowing way down as the frequency of additions and deletions 
increases. The store owners have called DATAPOINT to complain, and their local systems 
engineer has told them they need to reformat the files when they re-index, and has sold them 
another disk drive. 

The operator now types: 

INDEX DEADBEAT,BANK/ISI:DR1;F1-15 
INDEX DEADBEAT,DATE/ISI:DR1;19-24 
INDEX DEADBEAT,STORE/ISI:DR1;16-18 
INDEX DEADBEAT,NAME/ISI:DR1;193-216 

Note that the reformatting is done only once at the beginning. While it does no harm 
to reformat each time, it will waste much time and accomplish nothing. If reformatting had 
not been done when the first index was built, it could not be correctly done later without 
invalidating the previously built indices. 
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SECTION 18. KILL COMMAND 



KILL - Delete a file from the directory 
KILL (file spec} 

The KILL command deletes the specified file from the system if the file is not protected. 
If the file is protected in any way, the message 

NO! 

will be displayed. If the file specification is not given on the command line (file names which 
contain special characters cannot be given on the command line), the request for the file 
name: 

WHAT FILE? EXAMPLE: SCRATCH /TXT:DR1 
/ :DR 

will appear. The user must keyin an eight character filename (including spaces), a slash, a 
three character extension (including spaces), a colon/ the letters 'DR' and the drive 
number on which the file resides. If the entire filename specification is not entered properly, 
the message: 

NO SUCH NAME. 

will appear. If the specified name cannot be found (both a name and an extension must 
always be supplied if specified on the command line), the message: 

NO SUCH NAME. 

will be displayed. If the file is found and is not protected, the operator must additionally 
answer the message: 

ARE YOU SURE? 

with a 'Y' before the actual deletion of the file is achieved. After the deletion has occured the 
following message is displayed: 

*FILE DELETED * 
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SECTION 19. LIST COMMAND 



19.1 PURPOSE 

The DOS LIST program will list any DOS standard format text file on the CRT display, a 
local or servo printer. 

The DOS LIST program can be used for such things as: 

A quick scan of a file by displaying it on the screen (LISTing a file is faster than 
EDITIng it); 

Producing a hardcopy listing of a file for permanent records; 

Listing a file for use In preparation of a BLOKEDIT COMMAND FILE. 

In this Section, the following terms apply: 

Text file means a file with records containing only ASCII characters, except for 
space-compression bytes and the End-Of-Record and End-Of-File marks. Files created 
by DOS EDIT and those produced by DATABUS 7 and DATASHARE are in the class 
of text files. 

Line means one record of a text file. When displayed on the CRT display, only the 
first 68 characters of a record will be displayed; when listed on a local or servo 
printer only the first 120 characters will be printed. (The remaining twelve characters 
contain a line number.) 

Record means the logical record number (LRN). The first LRN of a file is zero. 
19.2 PARAMETERS 

When the LIST program is to be executed, the operator must type: 

LIST <filespec>{,spec2}{;{P},{X}} 

The square brackets ({)) indicate optional fields and the pointed brackets (<>) indicate a 
required field. 
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19.3 FILE SPECIFICATION 

The file specification (<filespec>) must refer to a DOS text file. If no extension is 
supplied with the file specification, an extension of TXT (text) is assumed. If no drive is 
supplied with the file specification, all drives will be searched for the filename/ext. If 
<filespec>is omitted, the message 

NAME REQUIRED 

is displayed. If the file indicated by <filespec>is not found on an online volume, the 
message 

NO SUCH NAME 

is displayed. 

19.4 STARTING POINT 

The operator may specify a line number, or logical record number, in the file at which 
the list should begin by including an optional second parameter {,spec2}with the file 
specification. For example: 

LIST <filespec>,L400 

would list the specified file beginning with the line 400 of the file. 

LIST <filespec>,R18 

would directly access logical record 18 of the specified file and list, starting at line number 
1. If a logical end of file is detected, the message: 

EOF - NEXT RECORD NUMBER: 

will be displayed. At this time the operator may specify another LRN in the specified file, or, 
by typing O', return control to the DOS. Similarly, if range or format errors occur, the error 
type is indicated and another record number is requested. 

If the line number specification exceeds the number of lines in the file, LIST returns to 
DOS. If the record number specification exceeds the number of records, the message 

RANGE - NEXT RECORD NUMBER 

is displayed. 

The DEFAULT value for the second parameter is line 1 and record 0. 
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19.5 OUTPUT DEVICE 

The operator may specify an output device {P}other than the CRT display by including 
an optional third parameter (S or L) with the file specification. For example: 

LIST <filespec>,L400;S 

would list the specified fila on the Datapoint servo printer starting at line 400. If no starting 
line number is required, the printer options should be specified following the semi-colon. For 
example; 

LIST <filespec>;L 

would list the specified file on a Datapoint local printer beginning at line number one. Any 
other entry will cause the CRT to be used. 

The DEFAULT device for the third parameter is the CRT display. 

19.6 OUTPUT FORMAT 

A second parameter (Xjis available to suppress line numbers. If the 'X' is entered, lines 
of up to 132 characters will be printed. For example: 

LIST <filespec>;SX 
would put the output on the servo printer without line numbers, whereas, 

LIST <filespec> 
would put the line numbered listing on the screen. 

19.7 OPERATOR CONTROLS 

The listing consists of a continuous stream of the listed file's text, preceded by the 
line's number in the file. To cause the listing to pause, the operator may hold down the 
DISPLAY key. To abort the listing, the operator may depress the KEYBOARD key. 

If the output device Is the local or servo printer, the output will be listed at 54 lines 
per page on continuous form paper, with each page numbered and titled by the file 
specification and an optional heading. The heading is entered by the operator when the 
LIST program displays the message: 

ENTER THE HEADING: 

before printing begins. The number of each line in the file will be printed at the left margin 
of the page. 
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SECTION 20. MANUAL COMMAND 

MANUAL - Clear Auto Execution 
MANUAL 
If the auto-execution name has not been set the message 
AUTO NOT SET. 

will be displayed. Otherwise, the directory location reserved for the auto-execution name wil 
be cleared and the message 

AUTO CLEARED. 

will be displayed. 
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SECTION 21. MASSACRE COMMAND 



MASSACRE - KILL all non-system files on a disk 

21.1 PURPOSE 

The MASSACRE command Is provided to ease the user's job of removing all files from 
a scratch disk. It deletes ail files on the specified logical drive without regard to whether or 
not delete or write protection is set. When MASSACRE completes, the only files remaining 
on the MASSACREd drive are the eight system files, SYSTEMO/SYS through SYSTEM7/SYS. 

21.2 USE 

MASSACRE < drive speo 

Before the specified disk is MASSACREd, the user is asked several times to 
acknowledge his request before actual deletion of the files begins. A typical console dialog 
would look something like the following: 

MASSACRE :DR2 

KILL ALL NON-SYSTEM FILES ON :DR2? Y 

ARE YOU SURE? Y 

REALLY? Y 

After the MASSACRE operation completes, only the eight system files will remain on 
the MASSACREd drive. Note: Users should consider regenerating the disk in lieu of using 
MASSACRE. MASSACRE maintains locked but areas of the disk but regeneration provides a 
thorough check of the disk during its process. The opportunity to recheck the disk hould 
not be overlooked. 
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SECTION 22. MIN COMMAND 



MIN - Read in Multiple Files 

22.0 PURPOSE 

^ The Multiple In (MIN) command is useful for reading multiple files (source, object and 

?r^!Tt'^ °^^^''*^ ^''°"' *^® ^'^"^ ^^^®**® ^^'^^ *° ^'s*^- '* w'" f^andle all standard single file 
(OUT, SOUT, and DSOUT), double file (SOBO), and multiple file (LGO, CTOS, and MOUT with 
or without a directory) tape formats. 

22.1 TAPE FORMATS 

Multiple In will automatically process the tape format by the following conventions If an 
option is given. 

22.1.1 SINGLE FILE TAPES 

An OUT (object out) tap© format has a file mark zero, a file mark one, an object file 
with entry point, and a file mark 0177. An object file has an address with the MSB and LSB 
m the fourth and fifth bytes of each record. Their complements are in the sixth and seventh 
bytes. The remainder of each record is filled with octal characters (ranging from to 0377). 

A SOUT (source out) tape format has a file mark zero, a source file, a file mark one, 
and a file mark 0177. A source file consists of records containing only ASCII characters, 
except for space compression bytes, physical end-of-record bytes, and logical end-of-record 
bytes. 

A DSOUT (Datashare object out) tape format has a file mark zero, a Datashare object 
file, a file mark one, and a file mark 0177. A Datashare object file has an MSB and LSB 
with complements in the first record similar to an object record. However, the remainder of 
the first record is filled with 377's.. The remaining records (128 bytes long on tape, 256 bytes 
on disk) represent pure Datashare object code. 

22.1.2 DOUBLE FILE TAPES 

A SOBO (source and object out) tape is the combination of a SOUT and OUT tape. It 
has a file mark zero, a source file, a file mark one, an object file with entry point, and a file 

mark 0177. 
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22.1.3 MULTIPLE NUMBERED-FILE TAPES 

An LGO (load and go) tape has a loader, a file mark zero, a string of files (the first 
being an object file and the rest may be source, object, and Datashare object intermixed) 
separated by sequential file marks, and a file mark 040. 

A MOUT (multiple out) tape without directory has a file mark zero, a string of files 
(may be source, object, and Datashare object intermixed) separated by sequential file marks, 
and file marks 040 and 0177. Single and double file tapes are included in this category if 
options are not used. 

22.1.4 MULTIPLE NAMED-FILE TAPES 

A CTOS (cassette tape operating system) tape has a loader, a file mark zero, a CTOS 
object file with entry point, a file mark one, a catalog object file, a string of files separated 
by sequential (though not necessarily contiguous) file marks, and a file mark 040. 

A MOUT (multiple out) tape with directory has a file mark zero, a tape directory, a 
string of files separated by sequential file marks, and file marks 040 and 0177. The directory 
is a source format file containing a date entry seven bytes long (DDMMMYY) and 31 file 
name entries each eleven bytes long (eight bytes for the name and three bytes for the 
extension). The entries are separated by end-of-string bytes (octal 0i5). This makes it 
convenient for display under CTOS LIST or to load to disk and list. 

22.2 PARAMETERS 

22.2.1 SINGLE FILE TAPES 

For OUT, SOUT, and DSOUT tape formats, the file specifications may be included on 
the command line in the following manner: 

MIN (<file spec>};<option> 

where < option > is an 'S' for SOUT, and a T' for DSOUT tape formats. 

File specifications are of the form FILENAME/EXT:DR#. If the drive is not given, all 
drives online will be searched starting at drive zero. If the extension is not given, the 
assumed extension (TXT, ABS, or TSD) will depend on the file format. MIN will identify the 
tape format. If the file name has not been entered on the command line, the program will 
ask: 

LOAD FILE #XX (format)? 

where, XX indicates the file number on the cassette and format indicates the type of 
file (SOURCE, OBJECT, DATASHARE), If the file is to be loaded, the response Y (yes) will 
cause the message: 
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DOS FILE NAME: 

to be displayed on the same line. If the response is N (no), the operator will be 
asked for the next file (if any). If the response is *. control is returned to DOS. If no name 
is entered, the message: 

NAME REQUIRED 

will appear. If the filename specified already exists, the message: 

NAME IN USE. WRITE OVER? 

will appear. The answer N (no) will cause the filename request to be displayed 
again.The answer Y (yes) will cause the disk resident file to be overwritten. If the file to be 
overwrittten is write protected, the message: 

•WRITE PROTECTED*OVERWRITE? 

will appear. If the response is not Y, the filename request will be displayed again. If 
the response is Y, the protection is changed from write protect to delete protect and the disk 
resident file is overwritten. When a file has been loaded from the cassette the message: 

LOADED 

will appear to the right of the filename. The message: 
MULTIPLE IN COMPLETED 

indivates the successful completion of the program. 
22.2.2 DOUBLE FILE TAPES 

The file specifications for a SOBO tape may be entered on the command line in the 
following manner: 



MIN 



:<file spec>}{,<file spec>};B 



File specifications are of the form discussed above. If the second file name is not 
given, the first name with the assumed extension of ABS will be used. If the extension is 
not given with the first name, TXT will be assumed. If the filename has not been entered on 
the command line, MIN will operate in the same manner as described in section 22.1.2.1 for 
each file on the cassette, displaying the messages in the same order for both files. 
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22.2.3 MULTIPLE NUMBEREO-FILE TAPES 

LGO tapes and MOUT tapes without a directory are both handled in the same manner. 
MIN is first executed as: 

MIN 

An LGO tape will then be identified as: 

LGO TAPE FORMAT 

In the case of multiple files, MIN will operate in the same manner as described in Section 
22.2.1 for loading a file without entering the name on the command line. The questions 
described will be asked for each file on the tape until end of file has been encountered on 
the tape or an *is entered in response to the 'load' question. MIN bypasses the loader on a 
LGO tape before searching for the file. If the file specified is not found, the message: 

FILE NOT FOUND 

will appear and MIN will be terminated. If the file is found and the file name is not 
entered on the command line, the file name will be requested as in single-file tapes. 

22.2.4 CTOS TAPES 

A CTOS tape will be identified as: 

CTOS SYSTEM TAPE FORMAT 

The system then searches for the catalog (tape file #1). Tlie CTOS file is fairly long 
so it takes a while. If the catalog file is not an object file or is an object file that loads into 
memory somewhere other than 017406 or 017410, the message: 

BAD CATALOG 

will appear and the remainder of the tape will be processed as a multiple numbered-file tape 
starting at tape file #2. If a good catalog is found, it will then be displayed as: 

CATALOG: <file Ixfile 2><file 3><file 4>. . . 

Then the operator will be asked: 

DO YOU WANT TO LOAD <file 1>? 

The entire process is identical to the multiple numbered-file tapes above except the file is 
referred to by name. The filename may be expanded from the six character name allowed by 
CTOS to the eight character name allowed by DOS plus the extension. A filename is 
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requested if the reply is 'Y'. 

22.2.5 MdUT WITH DIR6CT0RY TAPES 

These tapes are processed in a manner very similar to CTOS tapes. The tape is first 
identified as: 

MOUT TAPE FORMAT 
Next the date will be displayed: 

DATE: DD MMM YY 
Then the directory will be displayed: 

DIRECTORY: <file 1/extXfile 2/extxfile 3/ext>. . . 
Then the operator will be asked: 

LOAD <file 1/ext>? 

All the responses are the same as above except that the file name will not be requested. It 
will be the one displayed. The program will cycle until the end-of-tape file mark (040 or 
0177) is read at which point the message: 

MULTIPLE IN COMPLETED 

will be displayed. 

22.2.6 OPTIONS 

Tape file modifications may prevent MIN from automatically determining the tape format. 
In this event, the options 'L' (for LGO), 'C (for CTOS), or 'D' (for Directory) are available. 
Also, option 'N' (for No directory) will tell the system that it is handling a MOUT tape without 
a directory which allows entering the file names manually if the directory entry names are not 
desired. Options are entered following a semi-colon. 

These options are merely test overrides. If a tape, for instance, starts with a 
recognizable file mark, a loader won't even be tested for and therefore entering the 'L' option 
is meaningless. 

Unfortunately, MIN cannot differentiate an OUT, SOUT, DSOUT, or SOBO tape from a 
MOUT without directory tape. To speed the processing, the options 'S' (for SOUT), 'T (for 
DSOUT), and B' (for SOBO) are available. Once again, if the tape doesn't resemble a SOUT 
tape, for instance, entering an 'S' is meaningless. 

If the tape is a MOUT tape with a directory, the options 'A' (for All), '0' (for Overwrite), 
and Q' (for modifying the extension with Q's) are available. Using the option A' will load 
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all the files. However, if the fll^ already exists, the operator will be asked if overwriting is 
desired and if not, for a new file name. Entering the O' option in conjunction with the 'A' 
will force overwriting of existing files (unless write protected). If while processing in the 'All 
Overwrite' mode and a write protected file is encountered, the message: 

***WRITE PROTECTED*** 

will appear and processing continues with the next file. Entering the Q' option in 
conjunction with the A' will put as many Q's into the directory extension as necessary to 
create a new filename/ext if the original one already exists. If the original filename/ext 
exists, the message: 

EXISTING FILE 

will appear to the right before the modification to the extension is performed. If the 
filename/QQQ already exists, the message: 

OPTION EXHAUSTED 

will appear to the right and the file skipped. 

The option N' followed by an octal number allows that specific file to be loaded. For 
example, entering: 

MIN FILE/TXT;N12 

will load the tape file following file mark 12 (octal) to disk as 'FILE/TXT'. The default 
extension will be TXT' for source, 'ABS' for object, and 'TSD' for Datashare object files 
depending on the tape file format. If a non-octal number is entered (e.g. N8) the message: 

NUMBER NOT OCTAL 

will appear and fy/IIN will be terminated. If an unrecognizable record format is encountered, 
II ■€ messcig^: 

UNRECOGNIZABLE TAPE RECORD FORMAT 

will appear and MIN will be terminated. MIN bypasses the loader on a LGO tape before 
searching for the file. If the file specified is not found, the message: 

FILE NOT FOUND 

will appear and MIN will be terminated. If the file is found and the file name is not entered 
on the command line, the file name will be requested as in single-file tapes. 

The options L , C, N'. S', T", and B' are mutually exclusive. Only on6 may be 
entered The A' may be entered with or without the 'D' and with none of the other above 
options. O and Q' are mutually exclusive and may only be entered in conjunction with the 
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message: 

BAD OPTION PARAMETER 
will appear and the program will be aborted. 
22.3 ERRORS 

If the tape format is not one of the eight standard formats outlined above in Section 
23.1 (e.g. it starts with a file mark two) the message: 

INVALID TAPE FORMAT 

will appear and the processing will be aborted. If the end of tape is detected while 
processing, the message: 

***END OF TAPE*** 

will appear and the processing will be aborted. If a parity error, is encountered in an object 
or Datashare file on tape, the message: 

***PARITY ERROR-FILE DELETED*** 

will appear, the file name will be removed from the disk directory, and processing will skip 
to the next file. If a parity error is encountered in a source file on tape, the message: 

***PARITY ERROR-RECORD MODIFIED*** 

will appear, a 253 byte disk record will be written with percent signs in the first five 
positions of the record data, and processing will be continued with the next record. 
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SECTION 23. MOUT COMMAND 



MOUT - Write Out Multiple Files 
23.0 PURPOSE 

The Multiple Out (MOUT) command is useful for writing multiple (up to 32 or 31 if a 
directory IS used) disk files (source, object, and Datashare) out to the front cassette drive. 

An additional feature is the ablity to create a tape file directory as file #0 on the tape 
The directory is a source format file, that is, it consists entirely of ASCII characters except for 
space compression bytes, physical end-of-record marks, and logical end-of-record marks The 
directory contains a date entry seven bytes long (DDMMMYY) and 31 file name entries each 
eleven bytes long (eight bytes for the name and three bytes for the extension). The entries 
are separated by end-of-string bytes (octal 015). This makes it convenient to list under CTOS 
LIST or to load to disk and list. The directory is also used by the MIN program to enter files 
to disk. MOUT creates the directory in memory before the tape writing starts even if it is not 
to be written to tape. The writing of a full tape (over 500 records) takes about 10 minutes 
which shows the advantage of entering all the names before writing begins. • 

Another feature is the option to automatically verify a tape following its creation Or a 
previously written directory tape may be verified in an 'only verify' mode. If this is requested, 
the system will read the directory on the cassette tape in the front drive (if a valid directory is 
not found, the system will abort with the appropriate message) and verification will be 
performed agaifist the indicated files. 

23.1 PARAMETERS 

File specifications and/or options may be entered on the command line in the following 
manner: 

MOUT {<fiie spec>,<flle spec>,...}{;optlons) 

File specifications are of the form FILENAME/EXT:DR#. If the drive is not given, all 
online drives will be searched starting at drive zero. If the extension is not given, ABS is 
assumed. File specs are separated by anything (including multiple spaces) except letters, 
numbers, slash (/), or colon (:). 

23.2 OPTIONS 

Options (which follow a semi-colon and may be spaced) are 'L' for a loader format tape. 
'D' for a directory format tape, 'V for verification of the created tape, and 'X' for verification 
only. 



SECTION 23. MOUT COMMAND 23-1 



If a loader is to be written, the first file (file #0) must be an object file. There are no 
restrictions on files other than #0. 

The directory option ('D') will write a tape directory as file #0. The first item within the 

directory is the date entered DDfVIMfVlYY. Note: the month is entered as three alpha 

characters. The date may be entered following the option letter (e.g. D 12JAN74). If the date 
is not entered, it will be requested. 

The verify option (V) will verify all the files on the created tape. Verification consists of 
making a byte for byte comparison between the data on the disk and the data on the tape. If 
verification fails, the tape will be rewritten and verification tried one more time. 

The verify only option (X) will cause the first tape file to be read from the front deck. 
If it is a directory (first seven characters of DDMMMYY format), the remaining files will be 
automatically verified using the directory entries. If it is a loader, it wi?i be verified and file 
names requested for the remaining files as they are verified. An 'N' may be entered 
immediately preceding the 'X' to force the system not to recognize the directory. This would 
be done if manually entering file names is desired (for instance, the directory names don't ^ 
match the disk file names). If it is neither a directory or loader, file names are requested as 
the files are verified. 

If the semi-colon is entered with no entry following, it will be interpreted that the tape 
will not have a loader, a directory, or any verification. 

Entering D' and 'L' together or entering something with 'X' or entering some letter other 
than D', L', 'V, or X' will result in the message: 

BAD OPTION PARAMETER. MOUT DISCONTINUED. 

and the Multiple Out will be aborted. 

If file names and/or options are not entered on the command line, MOUT will ask for 
them as required. If options were not entered, the first question will be: 

DO YOU WANT A LOADER? 
Replys other than 'Y' or 'N' will be answered by: 

WHAT? 
and a repeat of the question. If the reply is 'N', the next question is: 

DO YOU WANT A DIRECTORY? 
Again, if the reply is other than 'Y' or 'N', it will be answered by: 

WHAT? 
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and a repeat of the question. If the reply is 'Y', the next request is: 
ENTER THE DATE (DDMMMYY): 

where the month is entered as three alpha characters. If the day is not in the range of 00 to 
39, the month not alpha, or the year not in the range of 70 to 99, the response: 

BAD DATE 
will appear and again the request for the date. The next question is: 

DO YOU WANT TO VERIFY THE TAPE? 
If the repl^ is not 'Y' or 'N', the response: 

WHAT? 

will appear followed by a repeat of the question. If the reply is 'Y' and the replies to the 
loader and directory questions are 'N', the question: 

DO YOU WANT TO ONLY VERIFY THE TAPE? 
will then be asked. If the reply is other than 'Y' or 'N', the response 
WHAT? 

will appear followed by a repeat of the question. If only verification is requested, the first tape 
record on the front tape deck is read in. If it is a directory (the first seven characters of 
DDMMMYY format), the remaining tape files will be automatically verified using the directory 
entries. If it is a loader, the message: 

LGO TAPE FORMAT 
will appear. The message: 

LOADER IS BEING VERIFIED 
will then appear as the loader is being verified. If the loader verifies correctly, the message: 

LOADER OK 
will appear to the right. Otherwise, the message: 

BAD LOADER 

will appear. After checking the loader or if the tape has neither a loader or directory, the 
message: 
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CASSETTE FILE #XX (format) DOS FILE NAME: 

will appear where XX is the file number and (format) is (SOURCE), (OBJECT), or 
(DATASHARE) depending on the file format. If nothing is entered, the message: 

NAME REQMIRED 

will appear and the request repeated. If an asterisk (*) is entered, MIN will terminate and 
return to DOS. If a greater-than sign (>) is entered, the program will skip to the next file. If 
a less-than sign (<) is entered, the program will backspace to the prior file (bypassing null 
files). If the program finds the beginning of the tape, it will beep and then move forward to 
the first file. If a name is entered, the default extension is TXT' for source, ABS' for object, 
and TSD' for Datashare object depending on the file format. If the drive number is not 
entered, all online drives will be searched starting at drive zero. If a drive number greater 
than DOS allows is given, the message: 

BAD DRIVE 

will appear and the request repeated. If the file is not found, the message: 

FILE NOT FOUND 

will appear and the request repeated. If the disk file is found, it will be matched byte by byte 
against the disk file. If the files completely match, the message: 

FILE OK 

will appear to the right and processing continues with the next file. If an error is detected, 
the appropriate message will appear and processing continues with the next file. Null files are 
bypassed. Processing continues until an end-of-tape mark (file mark 040 or 0177) is read at 
which time the message: 

VERIFICATION PHASE COMPLETED 

will appear and MOUT will be terminated. 

23.3 FILE NAMES 

If the file names are not given in the command line, 'the operator will be asked for the 
file names one at a time. The request is of the form: 

CASSETTE FILE XX DOS NAME: 

where XX is the file number. Possible replies to the file name query include: 

a) the file specifications as discussed above, 

b) a pound sign (#) which will bump the file number to 20 octal if not already there 

(only allowed on loader tapes to initiate numbered files on a CTOS tape). 
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c) /o5 a dollar sign {$) which will cause a null file (tape file mark only) to be written 
to tape and the file spec of NULL/NUL to be entered in the directory 

d) an asterisk (•) which will indicate no more files are to be entered and the tape 

writing started (writing is postponed until the directory is complete) and 

e) OS which will abort the program. The message- 

MULTIPLE OUT DISCONTINUED will appear and control is returned to DOS (To 
dump OS/ABS, enter 'OS/ABS' or 'OS'). 

If the operator fails to enter a name, the message: 

NAf^E REQUIRED 

will appear and the name request will be repeated. If the drive is given and is not in the 
range valid for DOS, the message: 

BAD DRIVE 

will appear followed by a re-request of the name. If the file is not found, the message: 
FILE NOT FOUND 

will appear followed by a re-request of the name. If the file is found, the format (object 
source, or Datashare) will be determined by the system. If the tape is a loader tape and file 
#0 is not an object file, the message: 

FILE FOLLOWING LOADER NOT OBJECT 

will appear along with a re-request of the file name. This message may also be displayed if 
the reply to the file name query for file #0 is a pound sign. Otherwise the messages: 

OBJECT FILE 



or: 



or: 



or: 



SOURCE FILE 



DATASHARE FILE 



NULL FILE 



will appear to the right of the file name. If the pound sign is entered for a tape that does 
not have a loader, the message: 



NOT LGO TAPE 
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will appear with a re-request of the file name. If 32 files (or 31 on a directory tape) are 
entered, the message. 

THAT'S THE END OF THE LINE 

will appear and the tape writing is started automatically. 

23.4 WRITING 

Once the tape writing has started, the system will keep the operator informed of its 
progress. As a loader is being written, the message: 

LOADER IS BEING WRITTEN 
will appear. As a directory is being written, the message: 

DIRECTORY IS BEING WRITTEN 
will appear. While files (including null files) are being written, the message: 

FILE <filename/ext>IS BEING WRITTEN 
will appear. When the writing is completed, the message: 

WRITING PHASE COMPLETED 
will appear. 

If a non-object record is sensed in an object file while writing to tape, the message: 

♦FILE CONTAINS NON-OBJECT RECORD* 

will appear and the next file is written over the bad tape file including the file mark. This 
will leave a directory entry without a file. If this should happen, it will cause verification to 
display the message: 

NON-SEQUENTIAL FILE MARK 

and the tape rewritten. 

If a non-source record is sensed in a source file while writing to tape, the message: 

♦INCORRECTLY FORMATTED SOURCE RECORD* 

will appear. The file is ended at this point without writing the bad record and the next tape 
file will start immediately following. If this should happen, it will cause verification to display 
the message: 
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***!NCORRECTLY FORMATTED DISK RECORD*** 



or: 



TAPE EOF BEFORE DISK EOF 

and the tape rewritten. 

if MOUT runs out of tape, the message: 

*END OF TAPE ENCOUNTERED WHILE WRITING filename/ext* 

will appear, an end of tape marker written at the end of the previous tape file, and the 
unwritten files will be removed from the directory {if there is one). Processing then will be 
continued with verification. 

23.5 VERIFYING 

If verification is requested, the system will keep the operator informed of its progress. 
As a loader Is being verified, the message: 

LOADER IS BEING VERIFIED 
will appear. As a directory is being verified, the message: 

DIRECTORY IS BEING VERIFIED 
will appear. While files (Including null files) are being verified, the message: 

FILE filename/ext IS BEING VERIFIED 
will appear. When the verification is completed, the message: 

VERIFICATION PHASE COMPLETED 
will appear. If verification Is requested for a tape having no directory, the message: 

NOT DIRECTORY TAPE 
is displayed. Then the message: 

CASSETTE FILE #XX(format) DOS FILE NAME: 

will appear. The filename should be entered Responses are discussed in section 24.2. 

A variety of error messages may be displayed during the verification phase. Most of 
them a self-explanatory. They include: 
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BAD LOADER 

BAD DIRECTORY 

TAPE FILE DOES NOT MATCH DISK FILE 

***INCORRECTLY FORMATTED DISK RECORD*** 

DISK FILE CONTAINS NON-OBJECT RECORD. 

DISK FILE CONTAINS NON-TEXT RECORD. 

NON-SEQUENTIAL FILE MARK. 

TAPE FILE MARK READ BEFORE TAPE OBJECT EOF. 

TAPE OBJECT EOF NOT FOLLOWED BY TAPE FILE MARK. 

DISK EOF BEFORE TAPE EOF 

TAPE EOF BEFORE DISK EOF 

If an error is detected, the system will then either rewrite the tape (if it has just been 
created) or skip to the next file (if in the only verify mode). If it rewrites the tape, the 
message: 

I'M NOW REWRITING THE TAPE 

will appear. The system will rewrite once before quitting completely at which point the 
message: 

VERIFICATION UNSUCCESSFUL ^ 

will appear and the processing terminated. 

If a problem arises that causes an abnormal end (e.g. end of tape), the message: 

MULTIPLE OUT DISCONTINUED 
will appear, otherwise the message: 

MULTIPLE OUT COMPLETED 
will signal the successful end of the program. 

***ERROR D ON DECK 2*** 
will signal parity errors on the cassette and control is returned to DOS. 
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SECTION 24. NAME COMMAND 



NAME will allow the user to change the name of a file, the extension of a file, or the 
subdirectory in which a file resides. The content of the file is unchanged. 

NAME - Change the name of a file 

NAME <file spec1>,{<file spec2>}{,< subdirectory name>} 

The first file specification refers to the current file name and the second file 
specification is the new name and/or extension to be assigned. If no extension Is supplied 
in the first file specification, ABS Is assumed. If no extension is supplied in the second file 
specification, the extension of the first file Is assumed. If no extensions are supplied, both 
files will be assumed to have extensions of ABS. The drive number should only be specified 
in the first file specification. 

If the NAME command is used to move a file from on© subdirectory to another the 
second file specification may be omitted (unless the filename and/or extension are to be 
changed) and the subdirectory name denoting the subdirectory into which the file is to be 
placed is the third specification: 

NAME < file sped >„< subdirectory name > 

In both uses of the NAME command, two specifications are required. If either name is not 
given, the message 

NAME REQUIRED. 

will be displayed. If the second name is already defined on the drive that contains the first 
file, the message 

NAME IN USE. 

will be displayed. Note that the drive specification on the second name is ignored. If the 
first name is not found on an online disk, the message 

NO SUCH NAME. 

will be displayed. If the subdirectory name keyed is not found on the disk containing the 
file to be renamed, the message 

NO SUCH SUBDIRECTORY. 
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will be displayed. If the third parameter is not specified, the file is 'brought into' the 
current subdirectory at the completion of the renaming process. 
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25.1 INTRODUCTION 

The DOS REFORMAT command is used to change the internal disk format of text-type 
{non-object) files. Additionally, it can recover disk space left unused when files are updated 
by the DATASHARE indexed sequential access method. REFORMAT can compress a file in 
place on disk provided that such compression does not entail the writing of a physical disk 
sector prior to the time that sector is read. REFORMAT maintains logical consistency in 
such cases and will not write on a disk file until it has checked to be sure it can complete 
its job successfully. 

25.2 SYSTEM REQUIREMENTS 

REFORMAT runs under the DOS operating system and requires a direct access device 
supported by the Disk Operating System. 

25.3 OPERATION 

When the REFORMAT program is to be executed, the operator must type: 

REFORMAT <file-spec>{,<file-spec>}{;<parameters>} 

where only the first file specification is mandatory, and specifies the file to be reformatted. If 
the second file specification is given, it must be distinct from the first. Reformatting in place 
is requested by omitting the second file specification. 

The parameter list describes the format the output file is to take, and whether 
REFORMAT is to free any disk space that might be vacated by the reformatting process. In 
addition, the user can specify that REFORMAT is to pad short records, and either truncate or 
segment long records. Reformat will produce three different kinds of output files: record 
compressed, space and record compressed, and blocked records (See Section 25.7 for disk 
file formats). Note that REFORMAT will not produce blocked space compressed records or 
space compressed non record compressed files although such files can be used as input to 
the REFORMAT program. 

The valid parameters that can be passed to REFORMAT are as follows: 

Parameter Description 

B<n 
The output file will be blocked. This implies no space or record compression, 
with <n>logical records per physical sector. 
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C The output file will be space and record compressed. The number of logical 
records per physical sector will be indeterminate. 

R The output file will be record compressed, but no space compression will be 
done. In general, the number of logical records per physical sector will be 
indeterminate. 

L<n 
> The length of each logical record will be adjusted to <n>characters. Note 

that if the logical records are space compressed, this will not make the 
physical length of the records <n>characters. If the logical record is shorter 
than <n>characters, it will be padded with blanks to the proper length. If 
the logical record is longer than <n>characters, the action taken depends on 
the T and S parameter. 

T (Only valid if L parameter is given) Truncate the logical record if it is longer 
than <n>characters. 

S (Only valid if L parameter is given) If the length of the logical record is 

greater than <n>characters, segment it into (q) logical records each of length 
<n>, padding if necessary. The number (q) is defined as input length divided 
by <n>rounded upward to the next integer. 

If neither S or T is specified, and an input record of length greater than 
<n>is found, a message is issued and REFORf^/IAT 
gives up. 

D If reformatting is done in place and this parameter is specified, any disk space 
vacated by the reformatting process will be returned to the operating system 
for re-use. 



25.4 OUTPUT FILE FORMATS 

The REFORMAT utility permits you to select essentially three different output file 
formats. It will produce blocked files that are not space compressed, record compressed files 
that are not space compressed, and files that are both record and space compressed. In 
addition, it has a subcommand to permit you to specify the logical length of the output 
records. Use of this subcommand will guarantee that each record has exactly the same 
logical length. Note that if the output format does not specify space compression, the 
physical length of each record will be identical. This is especially useful for 
telecommunications disciplines that require records of fixed length. 

If you have set a fixed logical length for output records, there are two subcommands 
available to tell REFORIVIAT what to do with records whose logical length exceeds the 
specified output length. You may select either truncation of the input record, or you may 
segment it into two (or more) output records, each of the logical length specified. 
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25.5 REASONS FOR REFORMATTING 

Several uses of REFORMAT deserve special mention. First, a random disk file is 
structured to have one logical record per physical sector. Often, however, it is convenient to 
create a random file through the use of the general purpose editor - which record and space 
compresses its output. REFORMAT can then reprocess the file into the correct format for 
DATASHARE or DATABUS random access. 

Secondly, when a file Is accessed with DATASHARE indexed sequential access method, 
any additions or deletions result in an increase in the physical size of the file. The reason 
for this is that any inserted records are placed at the physical end of the file, and each one 
consumes at least one entire physical sector, regardless of its logical length. Similarly, 
deleted records are simply overstored with octal 032 (logical delete) characters, and the 
space they vacate is not reused. REFORMAT recognizes this condition, and will recover 
such vacated space. Note that ISAM read-only or update-only (no additions or deletions) files 
do not usually need reformatting. 



25.6 REFORMAT |y|gs3/^QE3 

The RE 
The contents 



The REFORMAT utility program produces several messages on the operator's console, 
ontents and where necessary, meaning of those messages follow: 



REFORMAT VERSION T 
Self-explanatory. 

COMMAND LINE ERROR 

This is an internal error and should be reported to Datapoint. 

PROGRAM ERROR - EXCESS FILE SPACE NOT DEALLOCATED 

TO PREVENT POSSIBLE LOSS OF DATA 

REFORMAT has detected an invalid end of file mark. In order to prevent 
the possible loss of data which might be after the invalid end of file 
indicator, space allocated but unused is not freed. 

EXCESS FILE SPACE NOT DEALLOCATED; OUTPUT FILE IS 
DELETE PROTECTED. 
Self-explanatory. 

OUTPUT FILE IS WRITE PROTECTED AND CANNOT BE 
WRITTEN INTO OR SHORTENED. 

You have requested REFORMAT to output to a write-protected file. 
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INVALID OPTIONS SPECIFIED 

You have given REFORMAT an invalid parameter list. This message is 
followed by the valid options you may specify. 

ILLEGAL CONFLICTING OPTIONS 

You have specified two mutually exclusive options. 

YOU SPECIFIED BOTH SEGMENTATION AND TRUNCATION, 
YOU CANNOT HAVE BOTH 
Self-explanatory. 

BLOCKING FACTOR CONTAINS ILLEGAL NON-NUMER<C DIGITS 
Self-explanatory. 

BLOCKING FACTOR REQUIRED BUT MISSING OR ZERO 
You specified blocking but omitted the blocking factor. 

LOGICAL RECORD LENGTH REQUIRED BUT MISSING OR ZERO 

You must specify the logical record length of the output file if you wish to 
have fixed length output records. 

YOU HAVE ILLEGALLY ENTERED A SPECIFICATION FOR 
A THIRD FILE 

REFORMAT recognizes only two file specifications. 

HOW DO YOU EXPECT TO FIT THAT MANY RECORDS IN A 
256 BYTE SECTOR? 
Self-explanatory. 

LOGICAL RECORD LENGTH, IF SPECIFIED MUST 
BE <=250 BYTES. 
Self-explanatory. 

YOUR BLOCKING FACTOR IS TOO LARGE FOR THE SIZE 
OF THE RECORDS YOU HAVE. 
Self-explanatory. 

YOUR LOGICAL RECORD LENGTH IS TOO SMALL FOR THE 

SIZE OF THE RECORDS YOU HAVE 

While processing the input file, REFORMAT came across a record that was 
larger than the specified logical record length. Since you specified neither 
segmentation nor truncation, this is recognized as an error. 
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SPECIFIED OUTPUT FILE FORMAT ENLARGES PRESENT 
INPUT FILE. INPUT FILE CANNOT BE ENLARGED DURING 
REFORMAT-IN-PLACE. REFORMAT IN-PLACE REQUEST 
REFUSED. 

Self-explanatory. 

YOU SPECIFIED AN OUTPUT FILE THAT ENDED UP 
BEING YOUR INPUT FILE. TO REFORMAT IN-PLACE 
DON'T SPECIFY ANY OUTPUT FILE. 
Self-explanatory. 

INPUT FILE IS EMPTY! 

You are attempting to reformat a null file. 

OUTPUT FILE NOT FOUND ON DRIVE X. 

OUTPUT FILE FOUND ON DRIVE Y. 

OUTPUT FILE WILL BE CREATED ON DRIVE Z. 

These messages only occur if no specific drive was indicated for the output 
file. The first message appears followed by either the second or third. 
REFORMAT could not find the output file on the same drive as the input 
file. It either found one on a different drive, or created one on the 
displayed drive. If the output file is created, it is always created on the 
same drive as the one the input file is on. 

REFORMAT IN-PLACE REQUESTED. 
PRESCAN IN PROGRESS. 

REFORMAT is checking to make sure it can properly process the file 

inplace. 

FILE WAS ALREADY IN THE SPECIFIED FORMAT 
Self-explanatory. 

COPYING WITH REFORMATTING IN PROGRESS 
Self-explanatory. 

INPUT FILE NAME REQUIRED 

Either you gave only an extension or drive for the input file, or you 
specified the output file first, followed by the input file. 

INVALID DRIVE SPECIFICATION 

The drive number was greater than allowed or you did not specify the drive 
in the form :DR<n>. 
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25.7 TEXT FILE FORMATS 

Under Datapoint Corporation's Disk Operating System, text files consist of legal ASCII 
characters, which make up the text itself, and various special control characters with special 
meanings. It is illegal to have the control characters in the text portion of the file. 
According to DOS convention, and character between 000 and 037 is considered a control 
character. 

Each physical record of a text file is a logical disk sector, and contains 256 characters. 
The first three and last two characters are reserved for control functions; hence, the 
maximum space available in a single physical record is 251 bytes. The format of a logical 
sector is as follows: 

Offset Length Description 



000 001 Physical file number of this file. For a detailed description of 

physical file organization, see the DOS Advanced Programmer's 
Guide (Part IV). 

001 002 Logical record number. This refers to logical physical records, and 

is not related to text records within the file. 

003 373 Text. 251 bytes of text and control characters, depending upon the 
format of the file. 

376 002 Two characters reserved. 



The text part of each file is considered a logical stream, crossing sector boundaries 
without being logically discontinuous. Demarcations of logical record boundaries are made 
cniAiv/ hv/ rnntrni rh;:ir;^ntprR imbedded within the text itself. There are essentially five control 
Characters found in files generated by DOS: 000 <NUL>used for end of file indication, 003 
< EM > used to denote the end of medium (a sector boundary) but not the end of a 
logical record, 011 < CMP > used to denote space compression, 015 <ENT>used to denote 
the end of a logical record, and 032 <DLE>used to denote deleted data. 

Under DOS each file is treated as a single, continuous stream of data. Physical 
records bear no relation to the logical structure of the data contained in them. In this way, 
a proliferation of different file structures, and the special routines needed to treat such 
special cases has been avoided. This does not mean that there cannot be a relation 
between physical and logical structure, it simply means that such a relationship is incidental 
to a particular file, and need not be treated as a special case. For example, random access 
to a data file is defined in the DATABUS language. Files to be accessed in this manner are 
structured in such a way that one logical record corresponds exactly with one physical 
record. This structure is not inherent in the makeup of a random file, in fact, such files can 
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be treated exactly as any other text file. 

The basis for this treatment of text files Is the logical record. A logical record starts 
at the beginning of a file, or Immediately after the end of a previous logical record. It 
consists of ASCII data and is of no pre-determined length. Instead, the record is terminated 
with a single ENT character. In this way, complications arising from a multitude of record 
types are entirely avoided. 

If the logical record contains any CMP characters, it is said to be space-compressed. 
The character immediately following the CMP character is a space count, and the pair 
represent the number of ASCII blanks removed when the record was compressed. Since the 
character following CMP is always assumed to be a space count, CMP can never occur as 
the next-to-last text character in a physical sector, since the EM character following it would 
be lost. 

If the file is organized so that each physical sector contains exactly the same integral 
number of logical records, with no logical record spanning an EM character, the file is said 
to be blocked. If the file is not blocked, then it is said to be record compressed. Note that 
for a blocked file all sectors except possibly the last one in the file contain the same number 
of logical records while for record compressed files the number of logical records per 
physical sector is indeterminate. 

Under DOS conventions, a valid end of file mark consists of exactly six NUL 
characters, followed by an EM character: 

000 000 000 000 000 000 003 

This mark must begin at a sector boundary. All information after a valid end of file mark in 
the sector is indeterminate. 
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SECTION 26. REWIND COMMAND 



REWIND - Rewind the front cassette tape. 

The cassette in the front deck is rewound, if no cassette is in place in the front decl<, 
the rewind will proceed but only after a cassette is put into place. The cassette can be fully 
wound onto the clear leader at the very end of the tape, since the rewind command starts by 
Slewing the tape backwards for a few seconds first. This both takes up any slack that may be 
present in the cassette before the high-speed rewind starts, and also ensures that the tape is 
not on the clear leader when the actual rewind begins. 

Since the REWIND command uses the interrupt-driven cassette routines, the REWIND 
function has an interrupt process going until the actual high-speed rewind is begun. Until the 
backwards slew changes to a rewind, loading any other program in on top of the cassette tape 
drives (located from 010000 through 012377 in memory) is apt to cause the system to go astray 
upon occurrence of the next interrupt. 
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SECTION 27. SAPP COMMAND 



SAPP . Append two source files creating a third 
SAPP <fj|e spec>,{<fiie spec>},<fi!e speo 

The SAPP command appends the second source file after the first and puts the result 
into the third file. If extensions are not supplied, TXT is assumed. The first two files must 
exist. If the third file does not already exist, a new file will be created. The first file's end of 
file record is discarded and the copy is terminated by the end of file mark in the second file. 

Omitting the second file specification causes the first file to be copied into the third file 
Note that neither the first or second file is changed. 

The first and third file specifications are required. If either is omitted the message 
NAME REQUIRED 
will be displayed. 

The second and third file specifications must not be the same. 
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SECTION 28. SORT COMMAND 



28.0 INTRODUCTION 

The Disk Operating System SORT enables any Datapoint Disk user to initiate file sorts 
directly from the keyboard. 

Using a multi-train radix sort technique, the Datapoint processor achieves speeds 
comparable with much larger systems. The list of options also compares favorably with much 
more extensive systems. Nevertheless, since it uses the full dynamic nature of the Disk 
Operating System, it is extremely easy to operate. (Users who have spent several hours 
figuring out how to set up the myriad of SORT work datasets required by some other 
companys' sort packages know what we're talking about). 

For more sophisticated uses, SORT may be called from other programs through DOS 
CHAIN. Using CHAIN also enables complicated sort options to be reduced to a single file 
name then callable either from the keyboard or another program by that name. CHAIN also 
extends the SORT package to operate as a merge, as well. 

28.1 GENERAL INFORMATION 

28.1.1 Physical requirements 

SORT will optimize its speed through allocation of its working files on the available 
drives. During this process it attempts to ascertain the availability of sufficient disk space to 
achieve the desired sort. The program will abort at this point should the disk space be 
inadequate. 

28.2 FUNDAMENTAL SORT CONCEPTS 
28.2.1 What the files look like 

All Datapoint systems use a universal text file structure - Databus, Datashare, RPG II, 
Basic, Scribe, Editor, Assembler, Terminal emulators, etc. Therefore, any text file generated by 
or for any of the above may be sorted. The file to be sorted must be on disk, however. 

There are two sub-formats a Datapoint file can have: Indexed or Sequential. Notice 
that throughout the SORT section of the User's Guide, 'Indexed' refers to direct random, as 
opposed to ISAM, access. Indexed files are required to have a fixed relationship of a single 
string' or record' of data per physical disk record. SORT assumes indexed files have space 
compression. This implies that the logical position of a character in a record and the physical 
position of a character in a record may differ. The SORT will always expand the spaces to 
determine the logical position of a character. The maximum record size for indexed records is 
250 bytes. Sequential records have no fixed relationship to physical disk records and are 
written as densely as possible in the given file space. Nonetheless, indexed files can be read 
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sequentially in the identical way that sequential files are read. In fact, both types, when read 
sequentially, are indistinguishable. Indexed files are used for achieving random access to 
records. They generally require more disk space than sequential files for the same amount of 
data. 

When sorting, consider that the result of the sort is not restructuring of the original file. 
It is a NEW file which is a restructured COPY of the original file. The original file is never 
changed. 

Therefore, SORT produces a file which is a sorted version of the original. This gives the 
user the added opportunity of specifying the type of file to be output regardless of the input 
file format (with one restriction - see section 28.3.4). 

28.2.2 The key options 

The KEY of a sort is the FIELD or that part of the record which is to ORDER the 
sequence of records. For instance, it can be a. person's name, state, employee number, 
amount in debt or any aspect of the data base identifiable by a fixed position in the record 
based upon the column count from the beginning of the record. 

Consider the following record (column count scale below for reference only): 

Mule, Francis A. 242219 123 BARN SAN ANTONIO TX 

1 2345678901 2345678901 2345678901 2345678901 2345678901 234567890 

The name begins in column 1 and goes to 22. The employee number spans columns 24-29. 
The street address is 31-42. The city is 43-59. The State is 59-60 

If each person had a record in the file exactly in the above format, SORT could order 
the sequence of records in the file by any of the above fields. For instance, to get an 
alphabetical list of the records by name, the KEY would b^ 1 to 22 (hereafter referred to as 
1-22). The KEY for sequencing the file in order of employee number would be 24-29. The key 
for ordering the records by state then city and then employee number would be 
59-60,43-59,24-29. 

It should be obvious that any part of the record can be used as a key. It may not be 
obvious, however, that the larger the key, the slower the sort - it is the case and it is just 
about proportional. 

28.2.3 How to sort a file 

Sorting a file is done right from the keyboard of the DOS. All the operator must know 
is the NAf^E of the file to be sorted, the name desired for the sorted output file, and the 
definition of the KEY. 

For instance, the keyboard issued command for the above example to sort on the name 
field (1-22), would be: 
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SORT EMPLFILE,SORTF!LE;1-22 

This is assuming that the name of that file was EMPLFILE. It is also the operators 
decision as to what the resultant sorted file is called, as the command could have easily been: 

SORT EMPLFILE,EMPSORT;1-22 

as well. The second file named Is where the resultant sort will be placed. 

More complicated keys may be stated as well and the command to list by state and then 
name would be: 

SORT EMPLFILE,SOBTFILE;59-60,1-22 

That is all there is to simplified sorting. 

Testing SORT for yourself is simple. Most systems have a source code file for a 
Databus or Assembly language program on the disk. Such programs can be sorted by 
op-code and provide an interesting analysis of the usage of each instruction type: 

SORT INFiLE,OUTFILE;9-12 

28.3 THE OTHER OPTIONS 

28.3.1 Generalized command statement format 

The following is the generalized statement format for the Datapoint DOS SORT: 

SORT 
IN,0UT<,:DRk><,SEQ><;{<F><0><R><H><GNNNTG><N>}<K1>...<,0n><,Kn>> 

Information contained within a pair of corner brackets <> is optional and information 
within brackets is order-dependent, and commas may be used to delimit parameters. (NOTE 
that commas MUST be used to delimit sort-key groups.) The first four fields (those ahead of 
the semi-colon) are considered to be file specification fields. The fields following the 
semi-colon are considered to be sort key parameters. Default conditions are listed below. 
Typical statements obeying this format are: 

(1) SORT INFILE.OUTFILE 

(2) SORT INFILE.OUTFILE;1-3,7-20 

(3) SORT INFILE,0UTFILE;ID1-3 

(4) SORT INFILE,OUTFILE;IDL7-20 

(5) SORT INFILE,OUTFILE;LH11-20 

(6) SORT INFILE,OUTFILE,SEQFILE 

(7) SORT INFILE,OUTFILE,:DR0,SEQFILE/SEQ:DR1 

All the above statements will invoke a sort. Each will provide different results. However, 
notice thcit in (1) there are no other parameters than the file specifiers. That is because all 
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the specifiable parameters have a given value in case there is no specification for it. 
The following list defines the parameters which can be specified: 



IN 

OUT. 



This specifies the input file. This file must exist on disk. 



:DRk. 



This specifies the output file. This specification Is optional IF AND ONLY IF the 
L' AND 'H' options are used. If an output file is specified AND no 
disk drive is specified AND the file exists on a drive on-line to the 
system then the output file will over-write the existing file. If an 
output file is specified AND no disk drive is specified AND no file of 
that name exists on a drive on-line to the system THEN a file of the 
given name will be created on the same drive as the input file. 

.This specifies the drive for the sort key file. This is only a working scratch file 
needed during the sort. SORT will usually pick the optimum drive on 
which to put the work file on a multi-drive system. Experience or 
special considerations may cause the user to want to specify a work 
drive. 



SEQ NON-ASCII COIIATING SEQUENCE FILE 

This specifies the file which contains the collating sequence to be 
used. If omitted, ASCII will be assumed. 



F FORMAT. 



O ORDER. 



This parameter specifies the output file format: Indexed or 
Compressed (Compressed is also called Sequential). The actual 
character entered is 'C or T. The default value is 'C. 

Without typing the T, the output file will be SEQUENTIAL no matter 
what the input file. IF AND ONLY IF the input file is an INDEXED 
file, you may include the T parameter and cause the output file to 
be indexed. 



This parameter specifies the output file collating sequence: 
Ascending or Descending. The actual character entered is 'A' or 
The default value is A'. 



'D'. 



Without typing the 'D', the collating sequence order is considered 
ASCENDING. Including the D parameter will cause the collating 
sequence to operate in DESCENDING order. Note that if some keys 
are to be sorted in ascending order and other keys in descending 
order, the On specification described below should preceed each key 
whose order differs from the order of the key preceeding it. However, 
if all keys are to be ordered in the same sequence, only this 
parameter need be specified. 
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R RECORD FORMAT. 

This parameter specifies a special output record format: Limited 
output file format or Tag file output The actual character entered is 
'L' or T'. The default value is NO SPECIAL OUTPUT RECORD 
FORMAT; that is, neither 'L' nor T', so that the records in the output 
file will be exact copies (FULL IMAGE RECORDS) of the records in 
the Input file. 

Normally the sort transfers the entire records of the input file to the 
Output file. It Is possible, not only to transfer part of each record, but 
to Include constant literals in each record as well. Including the 'L' 
parameter in the list of parameters will cause another question to be 
asked wherein you may specify the limitations and constants. See 
section 28.3.6. 

Py entering the T' character an output file is generated which 
consists only of binary record number and buffer byte pointers to the 
input file records. See section 28.3.7. 

H HARDCOPY OUTPUT. 

This parameter specifies that the output of the SORT will be listed on 
a printer. The actual character entered Is 'H'. The default value is 
Hb HARDCOPY OUTPUT. 

Without typing the 'H' no printing will occur and SORT will require 
thalf an output file be named. If the 'H' parameter is given AND an 
output file is named then SORT will !ist the output to a printer AND 
win generate an output file. If the *H' parameter is given and NO 
output file is named then SORT will list ftie output to a printer and 
no disk file output will be generated. 

IF the 'H' parameter is given THEN the 'L' parameter MUST pi-ecede 
the 'H' parameter. 

SORT wilt print to a local printer o,' a servo printer. See section 
28.3.a. 

G GROUP INDICATOR 

This parameter specifies that the incut file consists of PRIMARY and 
SECONDARY records and specifies which GROUP is to be sorted. 
The actual character entered is 'P' for PRIMARY or 'S' for 
SECONDARY. There is no default value. 

IF the 'G' option is entered THEN the NNNTC options MUST ALSO be 
entered. 

In a file with PRIMARY and SECONDARY records a string of records 
with a PRIMARY record as the first record and SECONDARY records 
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following it is considered one block, or group, of records. 

When the file is sorted on PRIMARY records the output file has the 
blocks of records re-ordered so that the PRIMARY records are in the 
sorted sequence; no change is made in the sequence of the 
secondary records following each PRIMARY record. 

When the file is sorted on SECONDARY records the output file has 
the blocks of records in the same order as in the input file, but the 
SECONDARY records within each block are in the sorted sequence. 

SORT has no provision for the sorting of PRIMARY AND SECONDARY 
records in the same SORT run. 

NNN NUMERIC position of PRIMARY/SECONDARY flag. 

This parameter specifies the character position for the character (the 
C parameter) indicating whether the record is a PRIMARY or 
SECONDARY record . The number MUST be specified if the option 
is taken and must fall in the range 1 to 249. 

T TYPE of evaluation. 

This parameter specifies equivalence or inequivalence of the group 
indicator character; that is, whether the character in the record will be 
EQUAL to or NOT EQUAL TO the character specified. The actual 
character entered is '=' for equal or '#' for not equal. There is no 
default character, '=' or '#' must be given If the option is taken. 

If '=' is given then if the character in the NNNth position of an input 
file record is EQUAL to the group indicator character - indicated by 
C below -- then the record Is a member of the specified sort group 
-- indicated by 'G' above. Otherwise, it is not a member of the 
specified group. 

r~> r^U A D Ar'TCD rnrr\i>r\ inrlioatrjr 

\^ \y^ ir^iir^v-' i •-.• i, yi\yw|.^ n i^4iN.^«.4%w« 

This parameter specifies the actual test character for determination of 
a record's membership in the sort group. The actual character 
entered is any member of the character set -- this means any 
combination of eight bits -- except 015. There is no default 
character: the character immediately following the T' parameter is 
taken to be the C parameter -- except a 015. 

N This parameter specifies no space compression on output. This applies to FULL 

IMAGE and LIMITED OUTPUT files. It does not apply for INDEXED 
or TAG files. 



K1 SSS-EEE 



This is the first sort key specification. If no key is specified, the 
SORT will assume 1-10,i.e. the first ten characters of the record. 
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On. 



SSS is the starting key position. 
EEE is the ending key position. 

This ^P-'^-^ the order for the nth key (ascending and descending are indicated 
by A or D ). If omitted the order used on the previous key is 
assumed. ^ 



Kn SSS-EEE 



The nth sort key specification. The maximum number of keys is that 
which can be typed without exceeding ti^e input 



line. 



28.3.2 Keys-overlapping and In backwards order 

6 delilil'^H 'P^f ""*'°" "^^^ "°t b« on\y forward. A specification of 17-12 will cause the 
6 dehrnited characters to be a key but in the order of 17.16.15,14,13 12 This is extremeiv 
valuable, clearly, in data which has the most significant digit or character tst ' 

Key specifications may also be overlapping: 1-20,30-15 overlaps 15 to 20 When this 
occurs, the system will optimize the sort and save time over re-sor'ng on those I.umns 

28.3.3 Collating Sequence File 

standard '^T2rlT'"T'J'^r "" "'^' ""'^ '""^•""'^ ^"^ '=°"^''"9 ^<^"^"'^ <°^ '"e 
standard ASCII character set. The file name contains eleven characters .eight of which are 

hir h ! , ^ ^^^ °' '"^''°*' ^'^ '"^ ^"•^''^i"" <«'<a'"P'«' EBCDIC/SEQ:DRn) The last 

"des i^Tred'^SORT^rf"!.""' "^ '''°' " "-^ '''' "''' "-"- °" -^^^^ ''^"'« 
Thil th. Ik I ^/'^"'" '° '^^ ^^'"^ -^"ve ''°'" which the SORT itself was loaded. 

Th,s table may be supplied by the user but must meet certain requirements to be loaded: 

1. it must be an absolute object file. 

2. It must begin loading at location 027400. 

3. The first eleven bytes must contain the file name and the extension must be SEQ 

4. The table itself must begin loading at location 027400 and occupy 256 bytes 

5. If the file IS not found on the specified disk drive the following message is 

displayed: 

SEQUENCE FILE NOT FOUND 

6. If the file is found but is not an absolute object file the following message is 

displayed: 

SEQUENCE FILE FORMAT ERROR A 

^' '^n^nvV'""^* ^^^^^'^ ''^"''' *^® ^"® ^"' ^® '°^^ed using DOS routine LOADXS 
LOADX$ will return an error code if the load is unsuccessful. The following 
display will notify the user of the error: 
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SEQUENCE FILE FORMAT ERROR n 

where n- if file does not exist 

1 if disk drive is off-line 

2 if directory parity fault 

3 if RIB parity fault 

4 if file parity fault 

5 if off end of physical file 

6 if record of illegal format 

28.3.4 Ascending and Descending sequences 

Changing the collating sequence from ascending to descending is the same as 
reversing' the file, or placing the last first etc. Sorting a telephone directory in ascending 
sequence on name produces the familiar order. Should it be sorted in descending sequence, 
then Mr. Zyk would be first and Mr. Aardvark would be last. The order of collation, when 
alphabetic, numeric, and punctuation characters all pan occur in a column together, follows 
the character set order. The sequence may be specified for each sort key. However, it need 
not be specified if it is the same as the key which proceeds It.Therefore, it is possible to sort 
portions of the key in ascending order and portions in descending order. 

28.3.5 Input/output file format options 

SORT accesses each file sequentially. Due to the techniques used in the Datapoint 
standard file structure, the sequential reading technique will provide SORT with all of the 
records in the file whether the file was originally indexed or sequential. Therefore, the file 
format options only allow specification of the OUTPUT file's format. 

If the input file is INDEXED, that is one logical record or string per physical disk 
record, then you have a choice of output formats. If T is chosen, that is INDEXED, then each 
output disk record will contain an exact copy the appropriate input file record. If S' is 
chosen, that is SEQUENTIAL, then the input file, reordered, will be reblocked, space 
compression imposed, and appear, generally much more compactly, in the output file in 



" 'H* 



If the input file is SEQUENTIAL in its original format, then there is only one choice for 
the output format. The output file format for a sort on an input file which is sequential 
MUST be SEQUENTIAL. 

28.3.6 Limited output format option. 

In many cases, especially when making reports, directories etc. from the data base, it 
isn't necessary to have the entire record transferred from the input file to the output file 
during a sort For instance, an entire personnel data base can be sorted by name to 
produce an internal company telephone directory, However, it is obvious that all that is 
needed is the name and telephone number, NOT all the other payroll information. Therefore, 
SORT permits transferring only that part of the data base desired. 
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The following is the generalized statement Wrpot *-. ♦^.p ..^i-- -..-.. , - 

iv^ — .... .^..i.esi ,wi uig limiicu uuipui speciTication; 

l(SSS<-EEE>I.fQQQ.)</(p,NNNTC)>)<,(DUPUCATE OF PRECEEDINGj>... 

Within ?pirorri!r' ""*'" "'""•'"''' ^^^ ^"^^^'^"^ "^ '-^ -'^ °- '•«- 

< >1 nminn° P^^!"*'"^'^ "^^y "« ^P«=»i«d. and, all items within corner brackets 

seoa^lld h ' • ""' *'"'" "'""'^'^ ""^^y ^ ^«P^^'^'^ «"d must be 

separated by commas. 

The following list defines the parameters which can be specified: 

^^^ STARTING position within input record. 

^^^- ENDING position within input record. 

These parameters specify the character positions within the 
input record to be copied to the output record. The EEE 
specification is optional; if it is not specified then only one 
character, the character at SSS, will be copied from the input 
record to the output record. The SSS and EEE options must 
fall in the range 1 to 249. 



..ASCII TAG output. 

This parameter specifies that an ASCII pointer to the input 
record appear in the output record. The ASCII pointer points to 
the input file logical record number and the byte in that 
physical disk record containing the first byte of the input file 
logical record. If the T parameter was specified in the SORT 
options then, since the byte in the physical disk record 
containing the first byte of the input file logical record will 
always be '1'. the '1' will not appear. The ASCII pointer is a 
DATABUS 7 and DATASHARE compatable, leading-zero and 
space-compressed ASCII number. The number of digits for the 
logical record number pointer is four; the largest number that 
can be represented is 9696. The number of digits for the byte 
pointer (if it is generated; that is, the T parameter was not 
specified) is three; the largest number that can be represented 
is 250. 

QQQ QUOTED character string. 

This parameter specifies an actual string of quoted characters 
that is to be copied into the output recora. The quoting symbol 
is the single quote ' mark. The string may include any 
characters except the ' mark itself and 015, and must be less 
than 90 characters long. 

P PRIMARY record to be source. 

This parameter specifies that the information preceeding is to be 
extracted from the primary record for the current record block. 
This parameter has no effect when an output record is being 
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generated from a primary record. 

NNN NUMERIC position of evaluation character. 

This parameter specifies the character position fcr the character 
(the C parameter below) indicating whether the information 
preceeding is to be copied from the input record to the output 
record. The number must fall in the range 1 to 249. 

T TYPE of evaluation. 

This parameter specifies the equivalence or inequivalence of the 
evaluation character; that is, whether the character in the input 
record should be EQUAL to or NOT EQUAL to the evaluation 
charater. The actual character entered is '=' for equal or '#' 
for not equal. If the evaluation is satisfied, then the information 
preceeding will be copied to the output record. 

C CHARACTER, record evaluation. 

This parameter specifies the actual test character for record 
evaluation. The actual character entered is any character 
except 015. 

In the same manner that the key of the records is specified by fixed column 
number, i.e. 1-10 for the first ten characters, the limited output feature specifies that 
part of the records to be transferred. Should the response 1-10 be given to the 
limited output format request, only the first ten characters of each record will be 
transferred to the output file. Also, in the same manner that the key permits multiple 
discontiguous fields to be specified, the limited output format specifier operates. For 
instance, 1-10,50-70 would transfer thirty characters from each record of the input file 
to the output file. The eleventh character in the output record would be the fiftieth 
character of the input record, etc. 

To invoke the limited output format option, the operator includes the L' 
parameter in the specifier list, (see Section 28.3.1). If and only if the L is specified 
during the SORT call, will there be a second question asked of the operator on the 
next line: 

LIMITED OUTPUT FILE FORMAT: 

This question requires at least one non-trivial field specification or constant(see 
next paragraph). The number of field and constant specifications is only limited by 
that which can fit on the keyed in line. 

To permit even more utility in report generation, SORT allows inclusion of 
constants in the output record that didn't occur in the input record. For instance, 
assume that the personnel data base was a full record of about 240 characters and 
that the employees name appears in columns 80 to 110 and his telephone number 
was in columns 171 to 180. To make a telephone directory in alphabetical order, one 
could answer the following to the limited file output format request: 
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80-110; - ',171-180 

Note that this would put out the name followed by one space, a hyphen, one 
more space and the number. Any number of input file fields and constants can be 
placed in the output file up to the limit of the line on which the specification is 
typed. 

Also note that the output file requires proportionally less room than the input 
file when limited. Often this fact can be put to use when the disk file space is 
nearly exhausted and a sort is required. 

28.3.7 TAG file output format option. 

For some applications it is useful to have a data file sorted into several different 
sequences. However, to have several copies of a file on dick merely to have it in 
different sequences consumes a lot of disk space, and indeed if the file is a very 
large file many copies of it may not fit onto one or even fojr disk packs. 

This problem could be avoided if there were a way to index into the one main 
file in any of several different sequences. The index pointers could exist as a file, 
and the index entry for each record in the main file would only have to be three 
bytes long -- two bytes for the LRN (Logical Record Number) ana one byte for the 
BUFPTR (Buffer Pointer - a pointer to the beginning of the actual desired record 
within the disk physical buffer). 

SORT provides for the generation of such an indexing file, a TAG file, by the 
T' variation of the 'R' option. A TAG file may be generated for either a Sequential or 
Index file, and will have the same format for either file. The format of a TAG file is 
simple: 

1. For each record in the input file, the TAG file will have a three byte binary 

pointer to the first byte of the record. 

2. The format of the pointer is: 



Byte 1 
Byte 2 
Byte 3 



MSPLRN (Most Significant Portion of LRN), 
LSPLRN (Least Significant Portion of LRN), 
BUFPTR (Buffer Pointer). 



3. The three-byte binary pointers are blocked in a physical disk record. 

4. The Physical-End-Of-Record mark is an 003 and the rest OOO's. 

5. The End-Of-File mark is: beginning at the first byte in the physical record, six 

OOO's, one 003, and the rest OOO's. 

TAG files may be used by assembly language programs, by RPG II (as Record 
Address files), and by some Datapoint utility programs, such as the INDEX utility used 
to generate Indexed-Sequential-lndex files (files with extension 131). 
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For users writing their own Assembly language code to use a TAG file, it is 
important to know that the MSPLRN and LSPLRN are together a 16-bit binary pointer 
to the DOS LOGICAL RECORD NUMBER of the input file, as opposed to the USER 
LOGICAL RECORD NUMBER. The difference is this: The DOS LOGICAL RECORD 
NUMBER of a file points to the actual Nth record (starting with zero) in the file, 
whereas the USER LOGICAL RECORD NUMBER of a file points to the Nth DATA 
RECORD (starting with the zeroth data record) in the file. Thus a DOS LRN of zero 
points to the very first record of the file, which is the master copy of the RIB, a DOS 
LRN of one points to the second record of the file which is the RIB copy, a DOS 
LRN of two points to the third record of the file (which is the FIRST DATA RECORD 
of the file and the USER LOGICAL RECORD NUMBER zero), and so on. The LRN 
given in the TAG file can NOT be used with the POSITS routine unless it is biased 
by -2. It is much easier to simply place the LRN from the TAG file directly into the 
LOGICAL FILE TABLE ENTRY for the file that is indexed. Examples of this are in 
Section 28.7. 

The case with the BUFFER POINTER byte is similar to the LRN oointer bytes. 
The BUFFER POINTER byte from the tag file is the DOS BUFFER POINTER as 
opposed to the USER BUFFER POINTER. The difference is this: the DOS BUFFER 
POINTER points to the actual Nth byte of a disk buffer (starting with zero), whereas 
the USER BUFFER POINTER points to the Nth DATA BYTE in the disk buffer; the 
beginning (zeroth) DATA BYTE in the buffer is the fourth byte in the buffer; the first 
three bytes are reserved for the DOS. Thus, a DOS BUFPTR of zero points to the 
very first byte in the buffer, which is the PFN (Physical File Number) of the file, a 
DOS BUFPTR of ope points to the second byte in the buffer, which is the DOS 
LSPLRN. a DOS BUFPTR of two points to the third byte in the buffer, which is the 
DOS MSPLRN, a DOS BUFPTR of three points to the fourth byte of the buffer (which 
is the very first DATA BYTE in the buffer), and so on. The BUFPTR given in the 
TAG file can NOT be used with the GETR$ or PUTR$ routines unless it is biased by 
-3. It is much easier to simply place the BUFPTR from the TAG file directly into the 
LOGICAL FILE TABLE ENTRY for the file that is indexed. Examples of this are in 
Section 28.7. 

If the TAG file option is specified then the LIMITED OUTPUT FILE FORMAT or 
the HARDCOPY OUTPUT can NOT be specified. 

If a TAG file is generated when the P' (PRIMARY SORT) option is specified 
then TAG file pointers will be generated only to the PRIMARY records in the input 
file. 

If a TAG file is generated when the 'S' (SECONDARY SORT) option is specified 
then TAG file pointers will be generated that point to each PRIMARY record of the 
input file (in their original sequence) followed by pointers to the SECONDARY records 
in the record block in their sorted sequence. 

When a TAG file is generated for P' or S sorts, no indication is given in the 
TAG file pointer whether the pointer points to a primary or a secondary record; it is 
up to the user's program to check the records in the indexed file to determine when 
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a record block begins or ends. 

Section 28.7 is an example of the use of TAG files. The example program, the 
LlbTX program, is simply 3 program to read and display TAG-file-indexed files via the 
TAG file. In this program, the LRN is obtained by biasing the TAG file pointer by -2 
and using the DOS POSIT$ roi.tine(lines 161-168). but the BUFFER POINTER is used 
straight from the TAG file to the indexed file's logical file table entry (lines 170-172) 
Thus, examples of two different ways to use the pointers in a TAG file. 

This program can be used by the SORT user to check the output of a TAG 
SORT. A user planning to input a TAG file to a program he has written can thus 
assure himself that the data in the TAG file is as he expects it to be. It is always 
helpful when debugging a new program to know that the input data is correct. 

28.3.8 HARDCOPY output option. 

Many times it is desired to have a hardcopy (printed) output from a SORT 
instead of or in addition to the creation of a disk output file. This can be easily 
accomplished with SORT by specifying the 'H' (HARDCOPY) option along with the 'L' 
(LIMITED OUTPUT STRING) option. The 'H' option is essentially an expansion of the 
L' option because disk data files are almost never suitable for full image output to a 
printer; decimal points need to be inserted into dollar and cents amounts, dashes 
need to be inserted into part numbers, and spaces need to be placed between dollar 
amounts and part numbers to colunmnate the data, and so on. If it is desired to list 
output records in full image format, it is only neccessary to give: 

1-132 

as the limited output string specification. 

Sort will not send a line of over 132 characters to a printer. If the limited 
output specification designates a longer output record, then the full specified 
formatting will be applied to the disk output file (if any), but only the first 132 
characters of the record will be printed. 

If the following special characters are imbedded in the output record, they will 
be interpreted as indicated: 

015 =End-Of-Record and Carriage-Return/Line Feed. 
012 =Line Feed. 
014 =Form Feed. 

SORT will support either a local printer (address 0303: or a servo printer 
(address 0132). If a servo printer is on-line at the beginning of the FINAL MERGE 
then It is preferred as the output printer device; else a local printer will be used. If 
both printers are available on a system, selection between one or the other cannot be 
forced by parameterization; if output is desired to the local printer then the servo 
printer must be turned off. 
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28.3.9 PRIMARY/SECONDARY sorting considerations. 

If the P' (PRIMARY) or 'S' (SECONDARY) SORT option is used then the input 
file must have a PSPSPS.... format in order for SORT to work as expected, where P is 
one primary record and S is one or more secondary records. The first record in the 
file should always be a primary record, and the last record should be a secondary 
record. There should always be at least one secondary record following each primary 
record. Tertiary and further level records cannot be accommodated by SORT. 

In some cases it may be possible to successfully sort a file using the 'P' or S' 
options even if the file does not faithfully follow the above rules. However, the user 
must use great caution if he is to successfully fudge a system as complex as SORT. 
Pitfalls will be many. For example, if a file has the format PPPPSPSPS..., and a sort 
is done using the 'S' option, the output file will probably not contain the first three 
primary records at all. This case is true because when sorting using the 'S' option, 
pointers are generated for only the secondary records, prefixed by a pointer to the 
record preceeding the first secondary record of a record block. Since no secondary 
pointers were ever generated for the first three primary records, they are simply lost. 
It should be easy for the user to imagine what would happen to a file. if a tertiary 
sort were attempted. 

28.3.10 Key file drive number. 

There are three file systems associated with a sort. The first is, of course, the 
input file. The second is the output file. The third is the keyfile system. (The user 
only uses the output file - the keyfile system is a scratch file used by the system 
during sorting). There are actually two files which get opened during the sort for the 
keyfile system. They are *SORTKEY/SYS and *SORTMRG/SYS. These two files can 
grow to considerable sizes during the sorting procedure since they are proportional to 
the number of records and the size of the key field. 

There are two considerations for the location of the keyfile system. The first is 
the problem of room. The keyfile must be on a drive with sufficient room to hold it. 
The second is speed. The greatest increase in speed occurs in removing the keyfile 
system from the same drive as the input file. Greater speeds can occur if it is, as 
well, not on the same drive as the output file. Normally the SORT does a pretty 
good job of determining the best location of the two keyfile files and it shouldn't be 
necessary to specify anything for this. However, under complex circumstances, it may 
be desirable for the operator to specify the drive number for the keyfile. Should this 
be the case, the user should type in the <:DRk>specification as indicated in the 
general command format in Section 3.1. 
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28.3.11 Disk space requirements. 

A formula for determining the room in physical disk records that will be 
required for the SORT work files is: 

NT(L+P+3) 
R = ,. + 4 J 

S 

where: R =Room in physical disk records required on disk 

N =^Number of logical records in input file for which keys will be 

generated: 

=number of records in file if not sorting on V or 'S'. 

=number of primary records in file if sorting on 'P'. 

=number of secondary records In file if sorting on 'S'. 
L =Length of the sort key in bytes. 
P =3 if sorting on secondary records, 

if not sorting on secondary records. 
T =1 if only one sort key train is generated, 

=2 if more than one sort key train is generatsd. 
S =bytes per block of physical space available to the user 

The value of T can be computed exactly, but it is easier to make the general 
statement that short files will generate only one sort key train and longer files will 
generate more than one sort key train. Experience will soon develop empirical and 
intuitive knowledge for T evaluation for the user. 

28.3.12 LINK Into SORT from programs. 

There are three ways in which a SORT sort can be initiated: 

1. From the keyboard via the DOS COMMAND HANDLER; 

2. By using the DOS CHAIN command; 

3. By loading and linking to SORT/CMD from an assembly language program. 

Note that SORT can also be called from a DATABUS 7 or DATASHARE program 
by linking from those programs to an assembly language program which in turn links 
to SORT. Datashare users can also invoke SORT by using the rollout facility to start 
or continue a Chain (see CHAIN and the DATASHARE User's Guide for more details). 

Sort reserves for the user a nominal amount of storage normally occupied by 
the DOS DEBUGS routine. The specific memory locations saved are 06144 through 
06377. This permits the user to partially overlay his program with the SORT utility 
and regain control at the completion of the sort Additionally, the next page of 
storage, 06400-06777, is available to the user if full image output records are to be 
generated. The DOS interrupt handler is disabled during the sort but is re-enabled 
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upon completion of the sort. Of course, if the user has a foreground process running 
before and after the sort, the process must be controlled from within the memory not 
used by SORT, or when foreground is re-enabled it will vector to whatever SORT left 
in memory. 

The steps to call SORT from an assembler program are as follows: 

1 Close files 1, 2, and 3 if open. 

2. Set IV1CR$ (01400-01543) with the command string terminated by a 015. 

3. Load the SORT utility. 

4. PUSH the stack. 

5. Point HL to a parameter table with the format: 

PTABLE DA LIMSTG 
DA HEDING 
DA EXITAD 

6. RETURN 

Where: 

LIMSTG =the LIIVIITED OUTPUT SPECIFICATION string, terminated by a 015. If there 
is to be no limitation output specification, put 0. If there is a LIIVISTG, it 
must exist entirely within the range 06144-06377. The Llfy/ISTG must be 
exactly the characters as they would be entered from the keyboard. 
Examples follow. 

HEDING =the HARDCOPY HEADING string, terminated by a 015. If there is to be no 
hardcopy output, put 0. If there is a hardcopy heading string, it must exist 
entirely within the range 06144-06377. The HEDING must be exactly the 
characters as they would be entered from the keyboard. Examples follow. 

EXITAD =the first memory location to be executed upon successful completion of the 
sort. If the sort is to return to the DOS upon completion, put 0. If there is 
a specific exit address, it must exist within the range 06144-06377. 

Ki.^-.>^oii<' +h'> li-.c*'-'"^*''^'^^' ">* *h(y f>vH aHHrocc \aiUI loaH and run the OrOOram 

INUI IllCiliy , II IC II ion uv>li\yi 1^3 ui niC C/^ii <3v««-il w*»»* ¥•.■■• .ww.^ >...<.. .— .. .. .T_ ^._j3,.--- 

to be run after the sort, or will re-load a control program of the user's own 
control system. 

A simple example of loading and running sort from an assembler program 
would be: ^ 



1. SRTCMD DC SORT INFILE,OUTFILE'.015 SORT CMD STRING 

2. SRTNAf^ DC SORT CMD' NAME OF SORT UTILITY ON DISK 

3. PTABLE DA NO LIMITATION STRING 

4. DA NO HARDCOPY HEADING 

5. DA NO SPECIAL EXIT ADDRESS 
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6. RUNSRT LC SRTNAM-SRTCMD MOVE THE SORT COMMAND STRING 

''■ DE MCR$ TO MCR$ 

8 HL SRTCMD 

9 CALL BLKTFR 

^^- LC -1 LOAD THE SORT UTILITY 

^^- DE SRTNAM 

12 CALL LOADS 

^^ PUSH PUSH THE SORT STARTING ADDRESS 

^"^ HL PTABLE POINT TO THE PARAMETER TABLE 

15- RET RUN SORT 



The above sequence of instructions could be located anywhere in memory, 
except lines 13 thru 15 must obviously reside in a portion of memory from 06144 
thru 06377 to avoid being overlayed when the SORT utility is loaded from disk. The 
above instructions exemplify the simplest possible case of linking to SORT, in that 
only the SORT command and an INPUT FILE and an OUTPUT F'LE are specified, all 
other options are defaulted. " The above instructions have the sane effect as calling 
SORT by entering the line: 

SORT INFILE.OUTFILE 

to the DOS COMMAND HANDLER. 

Here is a line-by-line sxpianation of the Instructions: 

Line 1 defines the SORT COMMAND STRING. This is accomplished by a 
simple DC statement of a quoted ASCII string followed by a 015. The quoted ASCII 
characters are exactly the same that would be keyed in to the DOS COMMAND 
HANDLER if the sort were being initiated from the keyboard. The 015 is the string 
delimiter and is the same character that is placed after a string by the KEVINS routine 
when the ENTER key is depressed. The SORT command string can be up to 100 
characters long including the 015 because the MCR$ area is 100 bytes long. Note 
that this is nineteen characters more than can be specified ^rom the keyboard. 

Line 2 defines the name of the SORT utility main overlay. Notice that the 
complete name of the SORT given here must be exactly the name as listed in the 
DOS DIRECTORY of files. The eleven ASCII characters in a file name specification 
include an eight character FILENAME and a three character EXTENSION. Since the 
FILENAME of SORT is only four characters, it must be followed oy four spaces before 
the EXTENSION of CMD can be given. 

Line 3 defines the beginning of the six-byte PARAMETER TABLE. The first two 
bytes of the parameter table specify the address of the beginning of the LIMITED 
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OUTPUT SPECIFICATION string. In this example there is to be no limited output 
specification string specified, so an address of is given. 

Line 4 defines the address of the beginning of the HARDCOPY HEADING string. 
In this example there is to be no hardcopy output, so an address of is given. 

Line 5 defines the address of the EXIT ADDRESS, or the address to which the 
SORT is to exit when it is successfully completed. (If something goes wrong during 
the sort, exit is to the DOS.) In this example there is to be no special exit address, 
so an addess of is given. 

Line 6 begins the actual process of calling SORT from the program. Lines 6 
thru 9 move the SRTCfViD string from wherever it is in memory to the fv1CR$ area. 

Line 10 specifies that SORT is to be loaded from wherever it is found in the 
disk drives that are on-line to the system. Refer to the DOS SYSTEM MANUAL if you 
are not familiar with the DOS LOADS routine. 

Line 11 points to the name of the SORT utility main overlay in memory, given in 
SRTNAM, line 2. 

Line 12 calls the DOS LOADS routine which finds the SORT main overlay 
program on disk and loads it into memory, leaving the starting address in HL. 

Line 13 puts the starting address of SORT on the P-counter Stack. 

Line 14 points to the PARAMETER TABLE, lines 3, 4, and 5. The way that 
SORT knows that it is being run by the DOS COMMAND HANDLER or by a user 
program is by comparing the values of the HL contents and the top entry of the 
P-counter stack. If the values are equal, as they are immediately following a LOADS, 
then SORT asks for a LIMITED OUTPUT SPECIFICATION string and a HARDCOPY 
HEADING string if they are specified in the SORT COMMAND string. If the values 
are not equal, then SORT checks the memory pointed by HL for the location of the 
LIMITED OUTPUT SPECIFICATION string, the HARDCOPY HEADING string, and an 
EXIT ADDRESS. 

Line 15 effects the actual transfer of execution to the SORT utility. Since the 
starting address of the SORT was PUSHed onto the P-counter stack, a RETurn 
instruction JuMPs to the SORT starting address. 

Section 28.6 is an example of a DATABUS 7 program that links to SORT and 
back by the use of a pair of intermediate assembly language programs. 

A DATASHARE program can link to SORT by executing a ROLLOUT instruction 
to a user-built CHAIN file which includes the SORT COMMAND LINE and, if specified, 
the LIMITED OUTPUT specification line and a HARDCOPY HEADING line, followed by 
the TSDBACK program to re-load the DATASHARE. 
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Section 28.7 is an exampte of sophisticated usage of assembler language 
linkage to SORT. The assembler language program is in fact a SORTTEST program 
which dynamically generates various combinations of SORT options, including 
LIMITED OUTPUT SPECIFICATION strings and HARDCOPY HEADING strings, and 
then runs SORT for those options. The comments In the prog-am itself, and in 
general in the opening comments on page 2, explain in detai) what the program does 
and how it does it. 

28.4.0 THE USE OF CHAIN WITH SORT 

The reader should first familiarize himself with CHAIN by thoroughly reading the 
CHAIN Section. 

CHAIN is a system whereby the operator of a Datapornt Disc Operating System 
may pre-define a procedure sequence of his own programs, sysiem commands and 
utilities (including keyboard answers to questions requested by these programs) and 
have them called and , sequentially executed by a single name This is especially 
powerful when using SORT since there may be a repetitive sequence of routines with 
complex parameterizations which would make good use of a simplification. 

28.4.1 How to s«t up a chain file for sort 

The author of a chain file only needs to remember that ALL questions that the 
system requests INCLUDINQ those initiated by the executing programs MUST BE 
ANSWERED from the chain file just as though they would oe typed in from the 
keyboard. 

For instance, the initiation of a sort 'SORT INFILE,OUTF!L£;l3-42' could be done 
through chain. To do this, use the Editor to type in that exract sequence of 
characters into a file. Note that the file will, in this case, consist of a single line as 
typed above. The file can be any name, but for purposes of simplifying the 
explanation, it shall be referred to as CHAINFIL. If CHAINFIL consists of that single 
line, and if the operator types the command 'CHAIN CHAINFIL' to the DOS, the SORT 
specified above would be Initiated. If the 'L' specification were included in the 
statement above, then SORT would ask for another line of information. In this case, 
the file CHAINFIL would have to have two lines In it with the f?rst being the SORT 
command and the second being the limited output file format specification. 

28.4.2 Naming a repetitive sort procedure 

Frequently there are sorts and printouts and other procedures which occur 
together and for which a name invoking the procedure would oe a great 
simplification. 

For instance, in the telephone directory example above, the process of sorting 
the file into a limited output file and then listing it on a local printer could be 
procedurized as follows: 
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SORT EMPFILE,TELFILE;L80-110 

80-110," - M71-180 

LIST TELFILE;XL 

TELEPHONE DIRECTORY FOR XXXXXXXXXX CORPORATION 

Note that there are four statements. The first is the SORT command. The 
second is the answer to the limited format initiated by the L' in the SORT command. 
The third is the DOS LIST command with the specifiers of X' which says 'without line 
numbers" and the L" which, here, means local printer. Then there is a forth line 
which the LIST command requests - the heading. This question must also be 
answered in the chain file. If the above four statements were placed in a file by the 
Editor (or by any other means, for that matter) and then CHAIN were invoked with 
that file specified, the result would be a sorted telephone directory from the personnel 
files appearing on the printer. 

28.4.3 Initiating a sort from another program 

The chain file (CHAINFIL above) could have been created by any Datapoint 
system which can write a file. This makes the concept even more powerful since 
programs can create or modify subsequent procedures of itself, other programs, 
system commands and utilities. RPG II and Databus 7 especially can make good use 
of this. 

28.4.4 Using CHAIN to cause a merge 

Consider a situation wherein a system has a master file called 'MASTER' and a 
file of records to be added, in sequence, to the master file called 'ADDFILE'. To 
merge these two files in sorted sequence at the end of each day would normally 
require a sequence of keyed in operations which are somewhat complicated and error 
prone. CHAIN can cause an effective MERGE and assign it a single name as 
follows: 

SAPP MASTER.ADDFILE.MASTER 
SORT MASTER,SCRATCH;1-20 
KILL MASTER/TXT 
NAME SCRATCH/TXT,MASTER/TXT 

Note that the procedure: 

1) appends the ADDFILE to the MASTER file. 

2) Sorts the extended MASTER file into a SCRATCH file. 

3&4) Renames the SCRATCH file as the new MASTER file. Thus, it is apparent that a 
merge can be effectively achieved using SORT by using chain to pre-define the 
procedure. 
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28.5 SORT EXECUTION-TIME MESSAGES. 



This subsection describes the operator messages that SORT may display on the 
CRT screen during execution. Some of the messages are monitor messages to keep 
the operator informed of the progress of the program, while other messages are error 
messages. 



DOS SORT RELEASE m.n 

This message is the SORT sign-on and is displayed when the INPUT file 
specification and, if given, the OUTPUT file specification and the KEY DRIVE 
specification, have been accepted and SORT is ready to scan the option 
specifications. 

SORT OVERLAY MISSING. 

This message is displayed if the S0RT/0V1 file is not on the same drive as the 
SORT/CMD file. 

INPUT FILE REQUIRED. 

This message is displayed if no filename was specified for the first file 
specification. This would happen if a command lines such as: 

SORT ,OUTFILE or SORT /TXT.OUTFILE 

were entered. 

OUTPUT FILE REQUIRED. 

This message is displayed if no filename was specified for the second file 
specification AND if the 'L' and 'H' options were not specitied. 

BAD DEVICE SPECIFICATION. 

This message is displayed if a drive specification in a file specification was not 
entered in exactly the format; DR#where #is a valid drive number. 

OUTPUT FILE SAME AS INPUT. 

This message is displayed if the FILENAME and EXTENSION of the INPUT file 
and the OUTPUT file are the same, and the DRIVE NUMBER for each file is the 
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same or not specified for EACH file. 
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INPUT FILE NOT FOUND. 

This message is displayed if the INPUT file could not be found on any drive 
on-line to the system if no drive was specified, or on the drive given if a drive 
was specified. If no extension is supplied in the file specification an extension of 
TXT will be assumed; in this case if a file FILENAME/TXT is not on-line or on 
the drive specified then the INPUT file will not be found. 



INPUT FILE RIB ERROR. 

This message is displayed if a read parity error occurs when the INPUT files RIB 
is checked to determine the INPUT file's length. 



KEY FILE SPECIFICATION ERROR. 

This message is displayed if a FILENAME or EXTENSION is given for the KEY 
DRIVE specification. 



KEY FILE DEVICE SPECIFICATION ERROR. 

This message is displayed if the drive specification for the KEY file was not 
exactly in the format: DR#where #is a valid drive number. 



SORT KEY FILE PLACED ON DRIVE # 

This message is displayed if the KEY DRIVE was not specified on a multi-drive 
system. The message is to notify the operator of the location of the KEY file. 
The #stands for a valid drive number. 



OPTION FIELD ERROR. 

This message is displayed if a semicolon ; is entered at the end of the SORT 
command line but is not followed by any option specifications. 

OPTION SPECIFICATION DUPLICATION. 

This message is displayed if a command line such as: 

SORT INFILE,OUTFILE;DLA 

were entered. The 'D' and 'A' options are both variations of the ORDER option, 
and obviously both cannot occur simultaneously. 
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HARDCOPY ONLY IF LIMITED OUTPUT SPECIFIED. 

This message is displayed if the H' option is specified but the L option was not 
given previously. 



ILLEGAL HEADER SPECIFICATION. 

This message is displayed if the P" or S' option is given but is immediately 
followed by the 015 byte -- the ENTER key. 



ILLEGAL HEADER KEY EVALUATION. 

This message is displayed if the character immediately following the P' or S' 
option is not ' = ' or '#'. 



ILLEGAL SORT KEY SPECIFICATION. 

This message is displayed if a key position of or greater than 249 was 
specified, or if a key position was not terminated by , or - or 015, or if a 
two-position key was not terminated by , or 015. 



SORT KEY TOO LONG. 

This message is displayed if the total sort key is longer than 100 characters long. 

OVERLAPPING SORT KEY SPECIFICATIONS—SORT OPTIMIZED. 

This message is displayed if the same record positions were specified for more 
than one sort key group. SORT does not repeat duplicate positions in sort ke" 
generation and thus saves processing and disk read/write time. 

OVERLAPPING SORT AND HEADER KEYS— SORT OPTIMIZED. 

This message is displayed if the same record position is specified as a sort key 
position and a header indication position. The position is removed as a sort key 
position and the key is thus shortened. The effect is as for the previous 
message. 

LIMITED OUTPUT FILE FORMAT: 

This message is displayed if SORT has accepted the SORT command line 
including all option specifications and if the 'L" option has been given. The 
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Operator must enter the limited output specification line. 



NULL LIMITATION SPECIFICATION. 

This message is displayed rf the 'L' option was given but the limitation 
specification was only 015 .- the ENTER key. If the L' option is given then a 
non-empty limited output specification string must also be given. 

INVALID LIMITATION SPECIFICATION. 

This message is displayed if the limited output specification does not fit the 
syntax given in subsection 28.3.6 of the SORT Section. Usually the fault is that a 
comma was not placed between option specification groups, or double quotes ' 
were used instead of single quotes ' 



ENTER THE HARDCOPY HEADING: 

This message is displayed when the limited output specification has been 
accepted and if the H' option was given. The operator m.ust enter from to 79 
characters of information which will be printed at the top of each page printed 
during SORT output generation. 

SEQUENCE FILE NAME REQUIRED 

This message is displayed when the sequence file field is blank and the file 
specification fields have not been terminated with a semi-colon or an end of line 
designator. 

SEQUENCE FILE NOT FOUND 

This message is displayed when SORT requests the sequence file be OPENed 
and DOS cannot locate the file on the disk drive indicated. Note that if the drive 
is not specified, the drive on which the SORT/CMD resides is implied. 

SEQUENCE FILE FORMAT ERROR A 

This message is displayed when SORT determines that the sequence file specified 
is not an absolute object file. 

SEQUENCE FILE FORMAT ERROR n 

This message is displayed when SORT receives an error return from LOADX$ 
when an attempt is made to load the sequence file. The value of n may be 0-6 
and is defined as follows: 
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If file does not exist 

1 If disk drive is off-line 

2 If directory parity error 

3 If RIB parity fault 

4 If file parity fault 

5 If off end of physical file 

6 If record of illegal format.' 

LIMITATION SPECIFICATION OVERFLOW 

Thi is message indicates tfiat limited output parameters entered require more 
memory (256 bytes) than allocated by SORT. 

INTERNAL ERROR --GET SYSTEM HELP !!! 

This message indicates a probable hardware error occurred during a limited 
output string sort. SORT cannot continue executing. 

MERGE FILE OVERFLOW 

This message indicates not enough disk space is available for the merge file. 

FULL IMAGE OUTPUT RECORDS 

This is an informative message to the operator that full image records are being 
output by SORT. 

DOS SORT UTILITY REQUIRES 12 K 

This message indicates an attempt is being made to execute SORT in less than 
12K memory, which is the minimum storage requirement. 

OUTPUT FILE OVERFLOW 

This message indicates not enough disk space is available for the output file. 
THE FOLLOWING MESSAGES MAY BE DISPLAYED DURING SORT 
INITIALIZATION IF SORT WERE LINKED TO BY AN ASSEMBLY LANGUAGE 
PROGRAM: 

INVALID LIMITATION STRING ADDRESS. 

INVALID HARDCOPY HEADING STRING ADDRESS. 

INVALID USER EXIT ADDRESS. 

One of these messages is displayed if the corresponding entry in the parameter 
table linkage data was not either or in the range 06144-06377 inclusive. 
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LFT ENTRIES 1->3 NOT CLOSED WHEN SORT ENTERED. 

This message is displayed If the user left one of the logical files 1, 2, or 3 open 
upon linking to the SORT utility. 



LIMITATION STRING MISSING. 

This message is displayed if the 'L' option was given in the SORT command 
string but the pointer to the limited output format string in the parameter table 
linkage data was 0, indicating no limited output format string specified. 

HARDCOPY HEADING STRING MISSING. 

This, message is displayed if the 'H' option was given m tha SORT command 
string but the pointer to the hardcopy heading string in the parameter table 
linkage data was 0, indicating no hardcopy heading string specified. 



THE FOLLOWING MESSAGES ARE DISPLAYED AFTER THE SORT 
INITIALIZATION IS COMPLETED: 



BUILDING SORT KEY TRAIN 1. 

This message is displayed when all parameter specifications have been accepted 
and SORT has started the extraction of the sort keys from records of the INPUT 
file and is writing them to the *SORTKEY/SYS file. 



SORT KEY FILE OVERFLOW. 

This message is displayed jf there was not adequate room on the KEY DRIVE to 
hold the *SORTKEY/SYS file. If *SORTKEY/SYS file overflow occurs the file is 
deleted from the disk before the message is displayed. 



NULL OUTPUT FILE. 

This message is displayed if no sort key records were generated. If no sort key 
records are generated SORT cannot re-order the INPUT file, thus no output 
generation would be useful. 



INTERMEDIATE SORT PASS 1 

This message is generated during sorting of the sort key trains on the 
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*SORTKEy/SYS file. The only actual sorting done during a sort is 
that which can be done on the initial sort key trains, which are rnade short 
enough that they will fit in memory. After the sorting of the keys within each 
initial train, thfe trains are merged sixteen abreast into larger trains, repeatedly 
until only one train remains. 



INTERMEDIATE MERGE PASS 1, TRAIN 1 

This message is displayed if more than sixteen sort key trains exist during a 
merge pass. The intermediate merge pass number is the Nth iteration of the 
merge process. The train number is the number of the train being output by the 
merge pass. If more than one train is output by an intermediate merge pass then 
at least one more intermediate merge pass will be required. !f more than sixteen 
trains are output by an intermediate merge pass then at least two more 
intermediate merge passes will be required, and so on. 



FINAL MERGE: SORT TRAIN 1 

This message is displayed during the generation of the output file from the data 
in the now fully sorted and merged sort key file and from the records in the 
INPUT file. The sort train number corresponds to the current state of progress as 
measured against the number of trains generated by the next to the last 
intermediate merge pass. 



28.6 DATABUS 7 LINKAGE TO SORT 

This subsection describes and gives a detailed example of linkage to and from 
SORT by DATABUS 7 programs. , 

There is no direct way to chain or link from a DATABUS 7 program to SORT 
and from SORT back to a DATABUS 7 program. However, it is only necessary to 
write a pair of simple assembler language programs to interface between these two 
powerful business-oriented processors. The example used here to explain the 
proceedure includes two fairly generalized and complete assembler language interface 
programs. For most applications, the user can set up a DATABUS 7 program to link 
to SORT and use the assembler language programs as is. The only requirement is 
that the user set up his DATABUS 7 linkage program along the same lines as the 
example program. 

In fact, this example is somewhat fancy; it shows how to link back to a 
DATABUS 7 program and modify it before executing it. If the user does not want to 
modify a DATABUS 7 program, he can reduce the assembly language programs 
appropriately. Exactly how to do this is noted also. 

The example given does basically the following: 
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1. rirsi a listing ot the file to be sorted, the XDICT file, is produced on a printer. 

2. Next the program links to the SORT by CHAINing to ona ot the assembly 

language iinkage program?. 

3. Finally, the program having been re-loaded and slightly modified (one byte in the 

data area changed from a '1' to a '2'), the program produces a listing of the 
output file (XDICTSRT) on the printer. 

The assembly language programs in this example are sophisticated enough to 
be able to transfer from the DATABUS 7 program to the SORT utility a full 
complement of SORT option parameterizations. 

The DATABUS 7 program only needs to have a data area with the following 
format: 

1. The first field Is a numeric (FORf^AT) field having a one-digit number of '1'. This 

provides a simple data communication area between the DATABUS 7 program 
and the assembly language sort linkage programs. It is used simply so that the 
DATABUS 7 program will know whether it has already linked to the SORT. By 
using this technique, one and the same DATABUS 7 program can link into and 
out of a SORT, and be able to maintain control of the overall processing. 

This information exchange could also occur via a datafile with some special 
appropriate name such as SORTLINK. 

Of course, if it is desired to link into SORT from one DATABUS 7 program and 
resume execution with another DATABUS 7 program, the first field in this 
example is not needed. In the example assembly language program 
S0RTLNK1/DB7, line numbers xxx-yyy could be deleted 

2. The second field, SRTCMD, is a string variable definition thai is used to define 

the INPUT and OUTPUT files, and to specify the sorting parameter options. The 
first five characters of this field must always be 'SORT ', because those 
characters are checked for by SORT and define the name of the SORT system 
in the disk directory. This line is the same line as would oe keyed in to the 
DOS if SORT were being initialized from the keyboard. 

3. The third field, LIMSTR, is a string variable definition that is used to specify the 

LIMITED OUTPUT options. A string is given in this example even though the 
L' option was not given in the SRTCMD line. Note that the single quotes ' 
required by SORT does not conflict with the double quotes ' required by 
DATABUS 7. For the assembly language linkage prog'ams in this example, a 
one-charcter entry of '-' would be sufficient to locate the LIMSTR string variable 
and indicate that there really is no LIMITED OUTPUT string defined. 

4. The fourth field, HEDSTR, is a string variable definition that is used to specify the 

HARDCOPY OUTPUT HEADING. A string is given in tnis example even though 
the H' option was not given in the SRTCMD line. For the assembly language 
linkage programs in this example, a one-charcter entry of '-' would be sufficient 
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to locate the HEDSTR string variable and indicate that there really is no 
HARDCOPY HEADING string defined. 

5. The fifth field, RETURN, is a string variable definition that is used to specify the 
program to be executed upon return from the SORT. For this example, a name 
must be specified. 

Thus, for the programs given in this subsection, a DATABUS 7 program can link 
to SORT and specify the SORT COMMAND LINE, a LIMITED OUTPUT specification 
line, a HARDCOPY HEADING string, and can name the program to be excuted upon 
completion of SORT. 

It is hot necessary, of course, for all applications to accommodate all of the 
SORT specification options. But the example in this subsection should be ample to 
show and explain how to link a DATABUS 7 program to SORT. 
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PAbt 01 uAIAtJijb 7 Li.^,^ 1u buf^T DtMiJNST H A T IU'm PhiUGKAh" 



[hi5 lb A UMlMdUb 7 PHUGKAi^i i-^nlCh utMuiVi I km i tS Lii\iMr,ii, Fb Su"^ 1 . 
Fht HHUUHAiv; PtKf-UKMS i nt PULLOwiNG UPtKAl Iuimo : 

1. tiSrb Trtt XDICT FiLt. 

2. LiNK5 Tu Ihh bUHT 

3. LISTS Tht XDIC7SHT FILL, 

fht XDILT/rxl FILt IS LISIED otFUKt SQHUiMli IQ SrtUrt Tht I^PuT FILE FOR 
TMt SORT uPtRATIQN. 



LINKAGE TO Thfc SOKT IS ACCUMPLISHtD VIA A 
PROGRAMS. THE FIRST PROGRAM HESIUfcS IN HIGH 
WITHOUT OVtKLAYING PART Of THt OATABUS 7 INTE 
THE FIRST PROGRAM LOADS THE SECOND PROGRAM, »V 
RESERVED BY SORT F0« USER LINKAGE PROGRAMS. 
THE SORT COMMAND LINE, THE LIMITED OUTPUT SPE 
HtADiNG STRING, AND THE NEXT PROGRAM NAME TO 
bY MEANS OF THE DATA IN THE FIRST SIX FIELDS 
ASSEMBLER LANGUAGE PROGRAMS #(HICH SET UP THE 



PAIR OF ASSEMBLY LANGUAGE 
MEMORY SO THAT IT CAN t>£ LOADED 
RPRETER OR THE OATABUS PROGRAM, 
MlCH RESIDES IN THE MEMORY 
THE OATABUS 7 PROGRAM PASSES 
CIFICATION, THE MAROCOPY 
THE ASSEMBLER LANGUAGE PROGRAMS 
OF THE DATA AREA. IT IS THE 
LINK INFORMATION FOR SORT, 



THE XDiCTSRT/TXT FILE 13 LISTED AFTER SORTING TO SHOW THE OUTPUT OF THE 
SORT OPERATION. THE OATABUS 7 PROGRAM KNOwS WHICH PASS OF IT'S EXECUTION IT 
IS IN SY CHECKING THE FIRST DATA FIELD. 



25000 


PASS 


FORM 


£500i 


SRTCMO 


INIT 


25037 


LIMSTR 


INIT 


25060 


HEUSTG 


INIT 


25U6 


RETURN 


INIT 


25130 


PLINE 


DIM 


25252 


INFILE 


INIT 


25265 


OUTFIL 


INIT 


25300 


pagEno 


FORM 


25305 


HEDIi^b 


iivlT 


2536^ 


LiNENU 


I^URM 


25372 


PKfLi,. 


t-OKM 


2537b 


PKTLII*-. 


FUKM 


25«02 


ONE 


FORI*. 


25^05 


SKTL^'<^ 


IiMiT 



N 1 M 

"SORT XOICT,XDICTSRTni-20" 

"20-11, • ',1-60" 

"SORT FOR DATABUS 7 PROGRAM." 

"DB730RT" 



PASS NUMBER 

SORT COMMAND LINE. 

LIMITED OUTPUT SPECIFICATION 

HARDCOPY HEADING STRING. 

RETURN PROGRAM NAME. 



79 LIST RECORD I/O OUFFtR 

"XUICT " INPUT FILE NAME 

''X;)ICTSRT" OUTPUT FILE .^AM£ 

0" OUTPUT ''AGt NUMdEH 
" DATAdUS 7 PROGRAM PHUl/uCfcO LISTING OF •• 

" 0" OUlPUl LINE niUMbtK 

"^5" L^^.tS Tu PkIM per PACE 

"55" KESTUKE FOR AoUVt 

"1" INCREMEIMT NuwBtR 

"SOKlLNM" iMAflE UF 1ST aoSEmdLV PkOGHAM 
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25i*20 
25502 

25513 

25520 
25546 

25547 
25553 
25555 



PA5S1 
PASSlA 



DISPLAY 



bKANCM 

DISPLAY 

SfuP 

UPtN 
GUiU 
CHAl'.^j 



*Hl,*V12,*R,"DATAbUS / Pr^uGKA)^ SORT LiNNAGt UtMUNSI KAT ION" 
", PASS ",PASS 



PASS UF PASS1,PASS2 
"Invalid pass iSiufibtK," 



l,IwFiLfc. 

Pkluli- 
SKTLtt^ 



bKAiMtH TU PASS 1 uR pass 2 
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LibT Iht liMPul FILt 
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jJboOi jwcIwmCI U\t FKUf HnFLI*^ UtC^tf•t:«l Tht HkI.-^T LiNt CUUNftK 

(^5o0b Cmul >r«l.,Tr! ih <:t«u HKi.,iT HtAUiNU IF ll^t F-QH PAGE 

liboli rKi<»i Li'^.t'^Jf". "/KLiNt f-Ki.MT Tnt Liut 

^i6^0 i»uTU KtAl> LtJUK IF t^uT TI««t FOR A i^tlM PAbt 
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clbtobo ridoKri 
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cbbll oTuP 

25673 PASbi 

2b6/b PAbS2 

2bt>?7 pKi^TF 

2b701 PASSiA 

2b70i cRTcf'-U 

2b70b pKixTH 
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25711 PAbb 
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257 ib Ll '<oln 
257 1 / -ituol c 
25721 -^tTui^K 
25723 HLi-*t 
e:572D li^iFlLt 
25/2/ uuTriL 
257il PAoc'vo 
257i3 ntui .o 
25 /3b Li->.c *v 
c;b7i7 "^K I Ui . 
257Mi r'r(lui' 
2b/-^J U'vC 
2b/^Db«!L'.-^ 
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CONFIDENTIAL PROPS lET Aft y I»^FOKMaTXON 
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THE PURPOSE OF THE LOAN, 

NEITHER THIS ITEM NOR THE INFORMATION IT CONTAINS MAY BE USED OR OZSCLOIEO TO PERSONS NOT HAVING A NEED 
FOR SUCH use OR DISCLOSURE CONSISTENT WITH THE PURPOSE OF THE tOAN, WITHOUT THE PRIOR WRITTEN CONSENT OF 
OATAPOINT, 
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9, 
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19. 
I'D, 
IS, 

i«. 
jy 

i«, 

ii 

20. 
21 
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23 

24, 

2S, 

2i. 

27, 

2a, 

29, 
90, 
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94, 
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30, 
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4i), 

<l 

42, 

49, 

44, 

45, 

46, 

47 
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49, 

SB, 

SI 

52, 
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S4, 



B1006 
01911 
B1B7J 
01149 
01191 
01490 



06144 
06229 
06910 

06929 



29000 
29009 

97009 

97000 

37^03 
37016 
37031 

37044 
37045 
37046 
37^91 
37«54 
37(^96 
371*62 
37065 
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37^71 
3707S 
37U?1 
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040 040 040 040 040 

220 

320 

106 006 002 

14» 151 002 

026 377 

,846 003 Pifi 376 

106 071 e02 

14? 151 t*ki2 

970 

e46 000 \f}36 0i«3 

066 003 ese 046 

il^t 2?7 076 

046 144 036 tdl4 



SORTtNKl •- SORT LINK I 

THX8 18 I OF 2 ASSErtSL'^ LA^SUASE PROSRAMS TO LINK BETWEEN A DATABU5 7 
PROGRAM AND SORT, 

THIS PROGRAM RESIDES AttOVE THE DATaBUS 7 INTERPRETER AT »37000, THIS 
PROGRAM LOADS THE SECOND LINK PROGRAM AND SETS UP THE LINKAGE STRINGS, 



DOS EQU'St 



LDAOXS 

INCHL 

LOADS 

BLKTFR 

EXITS 

MCRi 



EQU 
EOU 
EQU 
EOU 
EQU 
EQU 



01090 
01911 
01071 
01143 
01191 
01490 



80RTLNK2 C0UI8I 



LXM8TR 
HE08TR 
XITNAM 
PTABLE 



EQU 
EQU 
EQU 
EOU 



06144 
LIM8TR499 
HEOSTR*90 
XITNAM*n 



8TART8 AT BEGINNING OF RESERVED MEMORY 
LIMSTR AND HEDSTR ARE 99 BYTES LONG 
XITNAM IS 11 BYTES LONG 



0B7S0RT EQUISI 



THE FOLLOi^XNG VAUUE 18 THE BEGINNING OF THE DATABU8 7 PROGRAM 
IF THE PROGRAM BEGINS AT AN ADDRESS OTHER THAN 029990 
THE VALUE OF PAIS MU8T BE CHANGED 
PASS EQU 929009 THE PA88 INDICATOR 18 THE FIRST FIELD 

SRTCMD EQU PAS8«9 THE SORT COMMAND LINE IS THE NEXT FIELD 



SET 097990 
J MP PASS 2 



SRTLK2 


DC 


*S0RTLNK2Ad3< 


UB7INT 


DC 


•DB7INT 


C«0' 


NXTPRG 


DC 


1 


1 


START 


SUA 
LCA 








CALL 


LOADXS 






JTC 


EXIT* 






LC 


-1 






OE 


SKTLK2 






CALL 


LOAD* 






JTC 


EXITS 






PUSH 






• 


OE 


MCNi 






ML 


3RTCM0 






CALL 


MDVSV 





OE 



LIMSTR 



SORTLNKl PASS 2 ENTftY POINT, 

name/EXTEnSION OF THE 2N0 PROGRAM 
NAME/EXTENSION OF OATaBUS 7 INTERPRETER 
NAME/EXTENSION OF NEXT PROGRAM (FOR PASS 2} 

LUAD THt pns UTILITY ROUTINES, THESE MUST flE 
LOADED TO MEMORY TO OVERSTQHE THE DATABU8 7 
INTERPRETER, SORT NEEDS THE DOS ROUTINES, 
DOS LOADED FIRST ELSE IT UVfcRSTURE 50HTLNK2, 
LOAD S0RTLNK2/ABS FROM ANY DRIVE 



JuST QUIT IF NOT FOUND 

tUSE SAVE THE ENTRY POInT On THE STACK 

MOVE THE 3DHT COMMAND STWiNU TU MC«» 



«uvfc THE LIMITED OUTPUT SPECIF IC AT lUN 
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CALL 


MOVSV 
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37113 
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OE 


HEDSTH 
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37117 
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UE 
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60, 


37131 
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LA 
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LL 
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UA 
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CP 
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70. 
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329 370 
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PTA8LE 
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37161 
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ess 




CP 
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PTABLC*9 
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A STRING VARIAB 
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65. 








■ 






86. 


37207 


317 




MOVSV 


LBM 




87, 


37210 


106 


011 002 




CALL 


I*«CHL 


86. 


37213 


327 






LCM 




89, 


, 37214 


3*^7 






LAM 




90, 


, 37215 


106 


013 002 




CALL 


IKCML*2 


91, 


, 37220 


30 S 






LAC 




92 


, 37221 


024 


001 




SU 


1 


93 


. 37223 


320 


, 




LCA 




94 


, .^722* 


331 






LAB 




95 


, 37223 


222 






sue 




9b 


. 37220 


32«* 






LCA 




&7 


. 37227 


»74 


062 




CP 


54* 


98 


. 37231 


140 


236 e76 




JTC 


MOVSVl 


99 


. 37234 


026 


M61 




LC 


49 


ia((« 


. 3723^ 


lee 


143 t^k'2 


HOVSVl 


CALL 


8LKTF« 


U'l 


. 47241 


t370 






PUSH 




li(J2 


. 672A2 


3b3 






LHD 




\'^i 


, 3724J 


364 






LLE 




1/4 


. .J724« 


<«i?fe 


^15 




LA 


ills 


1W15 


. 3724^ 


37^ 






LMA 




It'b 


^72^7 


360 






POP 




1/7 


. ^725^ 


31^.7 




MOVSVL 


LAM 




l!(*t 


. i725l 


»74 


2^3 




CP 


ki203 



MOVE TMfc HAROCOPY MtAOiNG 

MOVE THE PROGRAM NAME TO BE RU>» AFTER SORT 

RESET THE 019 TO BLANK 

MAKE SURE THE '0' Of THE '0B7« EXTENSION 
MAS NOT OVERSTORED 

CHECK FOR NULL LIMITATION STRING 

IF LIMITATION STRING NULL THEN CLEAR PTABLE 

THERE CAN>T SE A HAROCOPY HEADING 
CHECK FOR NULL HAROCOPY HEADING STRING 
IF 80 LINK TO 80RTLNK2 

LINK TO S0RTLNK2 

JTING AT ML TO MEMORY STARTING AT DE, 
FH A B19, 

B ■ LOGICAL STRING LENGTH 

C • FORM POINTEh 

HL ■> FORM POINTED CHa»«aCT£k 

COMPUTE NUMBER OF CHARACTERS TO MOVE 



DON'T HOVE MORE THAN 49 



MOVE FROM FORM POINTED CHAWACTES 

HL •> PS ■ CHARACTER AFTER LAST ONE MOVED, 

TERMINATE OE 5TWING InITh t?15 



RESTORE HL 
SCAN TO THE ETX 



PAGE 



e 5 




50RTLKKI/TXT 




109, 


37253 


15» 


eu 


?k2 




lie. 


37256 


lee 


011 


eii2 




Ul. 


37261 


lti4 


25P 


076 




us. 












113. 


37264 


026 


B13 






114. 


37266 


;i46 


031 


036 


i76 


115. 


37272 


066 


310 


096 


014 


lie. 


37276 


106 


143 


002 




117. 


37301 


026 


377 






118. 


37303 


046 


016 


036 


076 


119. 


37307 


106 


071 


002 




120. 


37312 


140 


191 


002 




121. 


37315 


026 


377 






122. 


37317 


046 


03} 


036 


076 


183, 


37323 


106 


071 


002 




124, 


37386 


140 


191 


002 




125. 


37331 


070 








126, 


37332 


006 


082 






127, 


37334 


066 


001 


096 


046 370 


126. 


37341 


060 








129, 


37348 


104 


014 


013 




130, 












131. 


37044 


, 









OATAPOINT CONFIDENTIAL INFORMATION m SEC PA6E 1 
SORT LINK I PROGRAH FOR OaTaBUS 7 TO/FROM SORT UlNKASfc 

POINT TO THE NfcXT CHARACTER AND EXIT, 



PA5S2 



JTZ 


INCML 


CAUU 


INCML 


JMP 


N0V5VL 


LC 


11 


DE 


NXTPR6 


HL 


XITNAM 


CAtU 


bLKTFR 


uc 


• 1 


DE 


D87INT 


CAUL 


LOADS 


JTC 


EXITl 


LC 


• 1 


oe 


NXTP^»S 


CALL 


LOAOt 


JTC 


EXiTi 


PUSH 




LA 


121 


H8A 


«PAS84>1 


POP 




JMP 


09414 



SAVE THE NAME OF THE PROeRAM TO BE SUN NEXT 



LOAD THE OATABUS 7 INTERPRETER 



JUST QUIT IF GONE 

LOAD THE NEXT PROGRAM TO SE EXECUTED 



JUST QUIT IF CONE 

ELSE SAVE THE ADDRESS ON THE STACK 

OVERSTORE THE PASS NUMBER 

RESTORE HL 

ENTER THE DATABUS 7 INTERPRETER 



ENO 



START 



DATAPOINT CONFIDENTXAW INFORMATION • SEE PACE i 
PAGE 6 SORTLNKl/TXT SORT LINK I PROGRAM FOR OATaBUS 7 TO/PROH SORT LiNKACfc 



1^1143 


BLKTFW 


*14 


1^50 


116 




37107 


CHKMEu 


6» 


♦75 






372etf 


CLRHEO 


73 


♦ 79 






37P16 


De7lNT 


♦ 38 


118 






pinsi 


EXITI 


♦ 15 


44 


48 


120 


06226 


HEOSTR 


♦ 21 


22 


96 


79 


01011 


INCMU 


♦12 


87 


90 


109 


06144 


tIMSTR 


♦ 20 


21 


94 


67 


01071 


UOAOt 


♦13 


47 


119 


129 


01006 


LOAOXS 


♦11 


49 






01400 


MCR* 


♦16 


51 






37207 


HOVSV 


53 


99 


97 


59 


37236 


MOVSVl 


98 


♦ 100 






37290 


M0V8VL 


♦107 


ni 






37031 


NXTPR6 


♦ 99 


114 


122 




23000 


PASS 


♦ 30 


31 


127 




37264 


PASS 2 


35 


♦113 






06329 


PTA8LE 


♦ 29 


71 


72 


79 


23003 


SRTCMD 


♦ 91 


52 






37«03 


5kTLK2 


- *37 


46 






37044 


STArtT 


♦ 41 


131 






i363l»5 


X1T^'AH 


♦ 22 


23 


be 


64 



124 



110 



♦ 86 



80 



116 



22 LAbtLS USEO 



PAGE I 30RTLNK2/TXT SORT LINK 2 PROGRAM FOR OaTaSUS 7 TO/PRQM SORT tlNKASE 

DOS ASSEMBUER 5,1 663 LABELS 

CONFIDE'^TIAL PROPSieTARY I^^FORHaTIOn 

THia ITEM IS THE PROPERTY OF DATAPOINT CORPORATION, SAn anTONIO, TEXAS, AND CONTAINS CONPIUEnTIAL AND 
TRADE SECRET INFORMATION, THIS ITEM MAY NOT 8E TRANSFERREU FROM THE CUSTODY OR CONTROL OF OATAPOINT EXCEPT 
AS AUTHORIZED BY OATAPOINT ANO THEN ONLY BY WAY OF LOAN FOR LIMITED PURPOSES, IT MUST NOT 8E REPRODUCED 
IN WHOLE OR IN PART AND MUST BE RETURNED TO OATAPOINT UPON REQUEST AND IN ALL EVENTS UPON COMPLETION OF 
THE PURPOSE OF THE LOAN, 

NEITHER TMI8 ITEM NOR THE INFORMATION IT CONTAINS MAY 8E USED OR OISCLOSIO TO PERSONS NOT HAVING A NEED 
FOR SUCH USE OR DISCLOSURE CONSISTENT WITH THE PURPOSE OF THE LOAN, WITHOUT THE PRIOR WRITTEN CONSENT OF 
OATAPOINT, 



PAGE 



80RTI.NK2/TXT 



DATAPOINT CONFIDENTIAL InFOR'^ATION - SEE ^ABI I 
SORT LINK 2 PROSRAH FOR OaTa6U8 7 TO/FROH SORT LiNKACfe 



UNUSEi' LAbELSl 



XITNArt 



PAGE 



50RTl.NH2/TXt 



OATAFOINT CONFIOENTJAI. INFORMATION « SEC FAGt 1 
SORT LINK 2 PROGRAM FOR OaTaSuS 7 TO/FROH SORT LINKAGE 



z, 

4, 
5, 
6, 
7 

e, 

0, 
10, 
U 
12< 
19, 
14, 
19, 
1S< 
17, 
IS, 
19< 

2e, 

21 
22, 

29, 

24, 

25, 

20. 

27, 

2S, 

20, 

90, 

91 

92. 

99, 

34. 

99, 

38, 

37 

38, 

39, 

40, 

41 

42, 

43, 

44, 

45, 



01071 



37000 

06144 

08144 
08226 
06310 
06923 
06329 
08927 



040 048 240 040 040 
144 014 
226 014 
963 814 



50RTLNK2 — SORT LINK 2 

THIS IS 2 OF 2 ASSEMBLY LANGUAGE PROGRAHS TU LINK dETMEEN A 0ATABU8 7 
PROGRAM AND SORT, 

THIS PROGRAM RESIDES IN m£«o»V RESERVED BY SORT FOR THE USER • 06144-08377, 
THIS PROGRAM LOADS THE SORT UTILITY AND LINKS INTO IT, WHEN THE SORT 
IS DONE RETURN IS TO THIS FROSRAH, WHICH IN TURN RE»iOA08 THE $0RTLNK2 
PROGRAM AND LINKS BACK To IT| MHICH IN TURN LINKS BACK TO THE DATABUS 7 
INTERPRETER, 

DOS EOU'St 
OAOS EQU 01071 

SORTLHKl EQU IS I 
ASSe E9U 097000 
SET 06144 



LIM8TR 
HED8TR 
XITNAM 
PTABLE 



SRTLKl 
START 



08391 123 \i7 122 124 114 

08344 026 377 

08348 046 377 036 014 

08392 106 071 002 
t58S95 970 

06996 066 323 066 014 

?63e2 B07 

(A6363 026 977 

06369 046 331 036 014 

06371 106 (^71 002 

t46374 104 000 076 



B6377 123 U7 122 124 040 SRTNAM 



SK 

SK 
DC 
OA 
OA 
OA 

OC 

LC 
OC 



90 

90 
I 

LIH9TR 
HE08TR 
RETURN 



0B7« 



E*»T«V POINT IS FIRST THREE BYTES IN PROGRAM 

START AT THE BEGINNINfi OF THE RCSCRVeO AREA 

ALtOM UP TO 90 CHARACTERS^ INCLUDING THE 019 

SANE HERE 

ROOM FOR FILENAME/EXTENSION 

POINTER TO LIMITED OUTPUT SPCCXFICATION 

POINTER TO HARDCOPY HCA0XN6 STRING 

POINTER TO RETURN ADDRESS 



• 1 

SRTNAM 
CALL LOAOt 

PUSH 

RET 



'S0RTLNKIDS7' NAHf/iXTCNSION OF THE FIRST PROGRAM 
LOAD THE SORT FROM ANY DISK DRIVE 



RETURN 



06344 



LC 
OE 

CALL 
JMP 

OC 

END 



PTABLE 

• 1 

SRTLKl 
LOADS 
PASS2 

'SORT 

START 



CMO' 



LIVK TO SORT 

LOAD THE SOHTlnkI PROGKAM FkOm ANY DRIVE 

£nTEW at The PaSS 2 ENTRY POINT 
name/EXTEnSIOn of The SORT UTILITY 



PAGE 



50RTLNK2/TXT 



0AT4PDINT CDNflOENTXAL InFORHATION - SEE PAQI i 
SORT LINK 2 PROGR*>» FOR DaTaBUS 7 TO/FROM aORT UlNKAGt 



1^6226 


HtOSTh 


*23 


26 


P6144 


Ll«STw 


*22 


25 


01071 


LOAD* 


♦ 14 


i3 


37eee 


PASS2 


•18 


41 


06323 


PTABLt 


*29 


35 


96363 


RETURN 


27 


*3S 


06331 


8RTLKI 


*29 


39 


00977 


8RTNAM 


32 


• 43 


06344 


START 


*31 


49 


06910 


XITNAH 


*24 





AVi 



Iff LASELS useo 



PAGE 



DATABUS 7 PROGPAM PRODUCED LISTING OF XDICTSRT 



1. 


>>> 


S 


<<< 


xanthate 


2. 


>>> 


P 


<<< 


xanthein 


3. 


>>> 


s 


<<< 


xanthic 


4. 


>>> 


s 


<<< 


xanthin 


5. 


>>> 


s 


<<< 


xanthine 


6. 


>>> 


s 


<<< 


xa nth lope 


7. 


>>> 


s 


<<< 


xanthochroid 


8. 


>>> 


s 


<<< 


xanthODhyl 


9. 


>>> 


s 


<<< 


xanthophyll 


10. 


>>> 


s 


<<< 


xanthous 


11. 


>>> 


s 


<<< 


xebec 


12. 


>>> 


s 


<<< 


xenia 


13. 


>>> 


s 


<<< 


xenogamous 


14. 


>>> 


s 


<<< 


xenogamy 


15. 


>>> 


s 


<<< 


xenogenesis 


16. 


>>> 


P 


<<< 


x^nogenetic 


17. 


>>> 


s 


«< 


xenogenic 


18. 


>>> 


s 


<« 


xenolith 


19. 


>>> 


s 


<<< 


xenotnorphic 


20. 


>>> 


s 


<<< 


xenon 


21. 


>>> 


s 


<<< 


xenophobia 


22. 


>>> 


s 


<« 


xeric 


23. 


>>> 


s 


<<< 


xeroderma 


24. 


>>> 


s 


<« 


xerophilous 


25. 


>>> 


s 


<« 


xerophily 


26. 


>>> 


s 


<« 


xerophthalmia 


27. 


>>> 


s 


<<< 


xerophyte 


28. 


>>> 


s 


<<< 


xerphthalmic 


29. 


>>> 


s 


<« 


xiphisternum 


30. 


>>> 


s 


<<< 


xiphoid 


31. 


>>> 


P 


«< 


xiphosuran 


32. 


>>> 


p 


<<< 


xmas 


33. 


>>> 


s 


<« 


xylan 


34. 


>>> 


p 


<<< 


xylem 


35. 


>>> 


s 


<<< 


xylene 


36. 


>>> 


s 


<« 


xylic 


37. 


>>> 


s 


<« 


xylidin 


38. 


>>> 


s 


<« 


xylidine 


39. 


>>> 


p 


<<< 


xylograph 


40. 


>>> 


s 


<« 


xylographer 


41. 


>>> 


s 


<<< 


xylographic 


42. 


>>> 


s 


<« 


xylographical 


43. 


>>> 


s 


<« 


xylography 


44. 


>>> 


s 


<<< 


xyloid 


45. 


>>> 


s 


<« 


xylol 


46. 


>>> 


s 


<« 


xyloohage 


47. 


>>> 


s 


<« 


xylophagous 


48. 


>>> 


s 


<« 


xylophone 


49. 


>>> 


p 


<« 


xylophonist 


50. 


>>> 


s 


<« 


xylose 


51. 


>>> 


s 


<« 


xylotomist 


S2. 


>>> 


s 


<« 


xylotomous 


53. 


>>> 


p 


<<< 


xylotomy 


54. 


>>> 


p 


<<< 


xyster 



SECONDARY RECORD: 5 
- X - PRIMARY RFCORD: 
SGCCNDAPy' ReCORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: A 
SECONDARY RECORD: 2 
SECONDARY RECORD: I 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: A 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 2 
SECONDARY RECORD: A 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 

- C - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 

- - PRIMARY RECORD: 



PAGE 



DATABUS 7 PROGRAM PRODUCED LISTING OF XOICT 



1. 


>>> P <<< xmas 


2. 


>>> S <« xebec 


3. 


>>> S «< xenia 


4. 


>>> S <« xenon 


5. 


»> S <« xeric 


6. 


>>> S <« xylan 


7. 


>» P <« xylem 


8. 


>>> S <« xylic 


9. 


>>> s <<< xylol 


10. 


>>> S <« xylene 


11. 


»> S <« xyloid 


12. 


>>> S <« xylose 


13. 


>» P <« xys.ter 


14. 


>>> S <« xanthic 


15. 


»> S «< xanthin 


16. 


>>> S <« xiphoid 


17. 


>>> S <« xylidin 


18. 


>>> S <« xanthate 


19. 


>>> P <<< xanthein 


20. 


>>> S <« xanthine 


21. 


>>> s <<< xanthous 


22. 


>>> S <<< xenogamy 


23. 


»> S «< xenolith 


24. 


>>> S <« xylidine 


25. 


>» P <« xylotomy 


26. 


>>> S <« Xanthippe 


27. 


»> S <<< xenogenic 


28. 


>>> S <« xeroderma 


29. 


»> S <« x«rophily 


30. 


>>> S <« xerophyte 


31. 


>>> P <« xylograph 


32. 


>>> S <« xylophage 


33. 


>>> S <« xylophone 


34. 


>>> S <« xanthophyl 


35. 


>>> S <<< xenogaroous 


36. 


>>> S <« xenophobia 


37. 


>>> P <<< xiphosuran 


38. 


>>> S <« xylpgraphy 


39. 


»> S <« xylotomist 


40. 


>>> S <<< xylotomous 


41. 


»> S <<< xanthophyll 


42. 


>>> S <« xenogenesis 


43. 


>>> P «< xenogenetic 


44. 


>>> S <<< xenoniorohic 


45. 


>>> S «< xerpphiious 


46. 


>>> S <<< xyXographer 


47. 


»> S <« xylographic 


48. 


>>> s <<< xyXophagous 


49. 


>» P <« xylophonist 


50. 


>>> S <« xanthochroid 


51. 


»> S <« xerphthalmic 


52. 


>>> S <« xlphisternum 


53. 


»> S «< xerophthalmia 


54. 


>>> S <« xylographical 



- - PRIMARY RECORD; 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- ^ - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD; 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 



28.7 EXAMPLE OF USE OF TAG FILE 

This subsection gives a detailed example of the use of the SORT TAG file 
output. The example is in the form of the complete program LiSTX, described in 
Section 28.3.7 of the SORT Section. 



SECTION 28. SORT COMMAND 28-31 



PASe I LISTX/TXT LIST AN iNDCXeO FILE PROCRAH 

DOS ASSfcHeLER 9,1 663 LABeLS 

CONFIDCNTlAt PROPrtieTARY INFORMATION 

This item is the PROPERTY OF DATAPOINT CORPORATION, SAN ANTONIO* TEXAS, AND CONTAINS CONFItiENTI AL AND 
TRADE SeCSeT INFORMATION, THIS ITEM MAY NOT BE TRANSFERRED FROM THE CUSTODY OR CONTROL OF OATAPOINT tXCEPT 
AS AUTHORIZED BY OaTAPOINT AND THEN ONUY BY WAY OF UOAN FOR UI«IT£0 PURPOSES, IT MUST NOT BE REPROOUCEO 
IN »<HOLE OR IN PART AND MUST BE RETURNED TO DATaPOInT UPON REQUEST AND IN ALL EVENTS UPON COMPLETION OF 
THE PURPOSE OF THE LOAN, 

NEITHER THIS ITEM NOR THE INFORMATION IT CONTAINS MAY BE USED OR DI9CL0SED TO PERSONS NOT HA¥{NG A NEED 
FOR SUCH USE OR DISCLOSURE CONSISTENT WITH THE PURPOSE OF THE LOAN, WITHOUT THE PRIOR WRITTEN CONSENT OF 
DATAPOINT, 



PAGE 2 



LISTX/TXT 



DATAPOINT CONFIOENTIAU INFOK*<AT10N • 9tt rA|»C 1 

LIST AN INDEXED FILE PROGRAM 



INCLUSION At OOS/EPT 



UNUSEO LAUCLSl 



EXTFDl 



PAse 



UISTX/TXT 



OATAPOXNT CONFIOENTIAL INFORMATION • SEE FAG6 I 
tlST AN INDEXED FlUe PROGRAM 



1. 
2. 
3. 
4. 
5. 
6. 
7. 

e. 



PROGRAM TO READ AND DlSPlAt INDEXED FIUES VIA THE iNOex ITA6) FIlE, 
INPUT SPfiClFlCATlXJN ISt 

LISTX XFILEiFILE 

MHERE I 

XFIUE IS THE NAME OF THE INDEX FILE (SORT TAG FIUE), 
FILE 18 THE NAUfi OF TKE INDEXED FILE, 



PA&C 



E 4 


tiSTX/TXT 


9, 




1«. 




l.A 




2. A 




3. A 




4. A 




5. A 




6, A 




7. A 




e.A 




9. A 


01000 


lU.A 


01003 


U.A 


01006 


12. A 


01047 


13. A 


01052 


14. A 


01053 


15. A 


0ie60 


16. A 




17. A 




18.A 




19. A 


01093 


2)4. A 


01096 


21. A 


01041 


22.A 


01044 


23. A 




24. A 




?5.A 




26. A 


01011 


27. A 


01022 


28. A 


01143 


29. A 


01146 


30. A 


0U51 


31. A 


14507 


32. A 




33. A 




34, A 




3S,A 


01063 


36. A 


01066 


37. A 


01071 


3B.A 


t»1074 


39.4 




4vt. A 




41. A 




42.* 


i'1077 


43. A 


1. 1 I fe) 2 


44, A 


CI IPS 


45. A 


/ 1 1 I u 


4^ , A 


^\ 113 


47. A 


5?lll6 


Ah ,h 


HUl 


4W, A 


v^l 124 


Sfr^, A 


d 127 


51. A 


eil32 


52. A 


f 1135 



OATAPOINT. CONFIOENTIAU INFORMATION - SEC PACt 1 
LIST AN INOEXEO FILE PROGRAM 

INC UOS/EPT 
TMI8 FILE CONTAINS THE 005 1,3 EnTKY POINTS 

LOADER ROUTINES 



BOOTS 

RUNXS 

LOADXi. 

CETNCH 

ORi 

OMt 

OSKkAT 



EOU 
EQU 
EOU 
EOU 
EOU 
EQU 
EOU 



01000 

01009 
01006 
01047 
01092 
01099 
01000 



RELOAD THE OPERATING SYSTEM 

LOAD AND RUN A FILE BY NUMBER 

LUAO A FILE BY NUMBER 

GET THE NEXT DISK BUFFER BYTE 

READ A SECTOR INTO THE DISK BUFFER 

MRITE A SECTOR FROM ThE DISK BUFFER 

■AlT FOR DISK READY 



TIME-CRITICAL SCHEDULING ROUTINES 



CSS EOU 

TPS EQU 

SETIS EOU 

CLRIS EOU 



01099 
01096 
01041 
01044 



CHANGE PROCESS STATE 

TERMINATE PROCESS 

INITIATE A TIM£»CRITICAL PROCESS 

TERMINATE A TIME^CRITICAL PROCESS 



, GENERALIZED PROCESSING ROUTINES 



EOU 
EOU 



INCHL 
OECHL 
BLKTFR EOU 
TRAPS EOU 
EXITS 
CMDINT 



EQU 
EQU 



010U 
01022 
81149 
01146 
0U9I 
014907 



INCREMENT HL 

decrement hl 

transfer a block of memory 
set a dish error condition trap 
Close all files and reload oos 
interpret mcrs as a command 



, SYMBOLIC FILE hanOiInC ROUTINES 



PREPS EQU 01069 

OPENS EOU 01060 

LOADS EOU 01071 

WUNi EOU 1^1074 



OPEN OR CREATE A FILE 
OPEN AN EXISTING FILE 
LOAD A FILE BY NAME 
LUAU AND RUW A FILE BY ^Aht 



. LOGICAL FILE HANDLING ROUTINES 



CLOSE* 


EOU 


^1077 


CHOP* 


EOU 


k9n02 


PROTE* 


EQU 


•^1105 


POSIT* 


EOU 


>« 1 u « 


HEAD* 


EOU 


1^1113 


WRITES 


EQU 


killlb 


GET* 


EUU 


v^n2i 


GETR* 


EOU 


01124 


PUTS 


EQU 


v^ll27 


PUTR* 


EOU 


01192 


BSPS 


EQU 


01195 



CLOSE A FILE 

DELETE SPACE IN A FILE 

CHANGE THE PROTECTION On a FIlE 

POSITION TO A RECORD »*ITHIN A FiLt 

ft£AD A kECORO into TMfc BUFFER 

*RITE A RECORD FROM THE BUFFER 

GET TrtE NEXT BUFFER BYTE 

GET AN INDEXED BUFFER PYTt 

STOHE INTO THE NEXT BUFFER P06ITIDN 

STORE INTO AN INDEXED BUFFEH POSITION 

BACKSPACE ONE RECORD 



PAGE 



e 


5 LISTX/TXT 


53 


*A 


54 


> A 


55 


• A 


56 


, A 1^1194 


57 


,A (^1137 


58 


»A «1162 


59 


.A 


6(9 


• A 


61 


.A 


62 


,A 1(300PI 


63 


.A 10009 


64 


.A 10012 


65 


,A 10017 


66 


.A 10024 


67 


,A 10031 


68, 


.A lJfleS4 


69, 


.A 10097 


78, 


>A 10042 


71, 


,A 10049 


78. 


,A 100B0 


73, 


A 10»93 


74, 


A 10096 


79. 


A 10061 


76. 


A 


77. 


A 


78. 


A 


79. 


A 00004 


60. 


A 00009 


61. 


A 00026 


82. 


A 00027 


83. 


A 00090 


84, 


A 01400 


69. 


A 01944 


66. 


A U000<9 


87. 


A 00020 


8«, 


H (d<^040 


89, 


A v^0060 


9^, 


A 


91, 


A 


92, 


A 


93. 


A 9l0k»00 


94, 


,A 0(4)001 


99, 


.A 0kl002 


96, 


A 00004 


97, 


,A ?B006 


96 


,A Pi|a^l0 


99 


.A ^eeii 


1141^ 


,A «1^(!!l2 


lfc}l 


.A ?v)ei4 


102 


,A /kiMlb 


lid3 


,A i«5?v?l7 


1»4 


1 A 


11^9 


, A 


1/6 


• A 



OATAPOINT CONFIDENTIAI. ISFORHATION • Sft Pk^t 1 
LIST AN INDEXED FILE PROSRAM 



KEYBOARD AND OISFLAV ROUTINES 



OE&UGS EQU 
KEY INS EOU 
l)SPLY» EQU 



ie>1154 
«1197 
^1162 



ENTgH THE DEduaClNG ROUTINE 
OeTAlN A LINE FROM THE KfYSUAhO 
DISPLAY A LINE ON THE SCREEN 



CASSETTE TAPE HANDLING ROUTINES 



TPeOFS 

TPEOF* 

TRWl 

T68P1 

TMBLKS 

TRI 

TREADS 

TwS 

Tj«R1TS 

TFMRS 

TFMJUi 

TTRAPi 

Tl-AITS 

TCHKS 



EQU 

eou 

EQU 
EOU 
EQU 
EQU 
EQU 
EOU 

£au 

EQU 
EOU 
EOU 
EQU 
EQU 



idl0000 
010009 

010012 

010017 
1 0034 
010031 
010034 
010097 
0100*8. 
010f49 
010090 
010093 
010096 
(()li(iie61 



INTERNAL 008 EQUIVALENCES 



005PFN 
OQSPDN 
DOSPTR 
SDFLA6 

8DNR 

MCRS 

LFT 

Lf0 

LFl 

LF2 

LFd 



EQU 
EOU 
EQU 
EQU 
EOU 
EOU 
EQU 
EQU 
EOU 
EOU 
EOU 



00004 
00008 
00026 
00027 

00030 

01400 

01944 

0«4 

l<4 

2*4 

344 



POSITION TO THE BEGINNING Of A FILE 

POSITION TO THE END OF A FILE 

PMVaiCALLV REWIND A CASSETTE 

PHYSICALLY BACKSPACE ONE RECORD 

WRITE AN UNFORMATTED BLOCK 

READ A NUMERIC CT08 RECORD 

TRI AND WAIT FOR LAST CMAWACTER 

WRITE A NUMERIC CT08 RECORD 

Twl AND WAIT FOR LAST CHARACTER 

REAO THE NEXT FILE MARXtR RECORD 

WRITE A FILE MARKER RECORD 

SET A CASSETTE ERROR TRAP 

WAIT FOR I/O COMPLETION 

GET I/O STATUS 



PFN FOR USE BY DRS AND OWS 
PDN FOR USE BY DRS AND DWS 
SUFPTR USED BY GETNCH 
8UB»02R£CT0RY EXI8TANCE FLAG 
SUB«0IRECT0RY NUMBERS (1 PER DRIVE} 
HONJTOR COMHUNICATION REGION 
LOGICAL FILE TABLE 
LOGICAL FILE #0 
LOGICAL FILE «1 
LOGICAL FILE #2 
LOGICAL F;lE »3 



LOGICAL FILE TABLE OESCRIPTIG^ 



PFN 

PON 

LKN 

aLRN 

CSD 

KI8CYL 

WIHSEC 

HAXLR^J 

LHNLIM 

BJFAOR 

XXXXXX 



EQU 
EQU 
EQU 
EOU 
EOU 
EQU 
EUU 
EQU 
EOU 
EOU 
EQU 



VI 

1 

2 

4 

6 

B 

9 

10 

12 

14 

16 



(J? 
(I) 
t2) 
C2) 
(2) 
(1) 
(1) 
VI) 
C2) 



PwvSICAL FILE NU^'BEW 

Physical drive nuhbeh ano pwotection 
next lrn to be dealt with 
fip8t lhn within current seghtwt 
Current segment oescriptoh 
cylinder containing the rib 
sector containing the wib 

LARGEST LRN REFfcRtNCED 

LARGEST LRN ALLOWED 

CURPEnT CONTROLLEH buffer ADOWfeSS 



(I) NOT USED 



DOS 1,3 MEMGKY MAPPING 



PAGE 



E 6 


LISTX/TXT 


li«7,A 


00000 


108,* 


aieec" 


1^9. A 


1^41^ V1<<? 


UV^.A 


054e)M 


111. A 


05572 


112. A 


Ztididfd 


lli.A 


tB74i\d 


1 1 4 . A 


i(40ei0 


lis. A 


1240V 


116. A 


170Pi^ 


117, A 




lie, A 





UATAROJNT CUNFIOENTIAL InFOS'^aTIOn - SEE PAGE 1 
LXST AN INDEXED FILE PROC^am 



LORAO* 


EQU 


kt(i(^(iae 


DOSAOS 


EOU 


i<ei«)0P 


OVLADt 


EQU 


>d9A^idt^ 


OSPAD* 


EQU 


i9094ie 


KEYAOS 


ECU 


«ikd5972 


oeaAD* 


EQU 


id96etfk> 


UNPADS 


EOU 


i9vt74tf0 


CASADS 


EQU 


k'l*<»k»« 


CHOAO* 


EUU 


1^12445 <• 


COVAOi 


EOU 


0l7Meill 



SYSTEM LOADER 

UOS RESIDENT 

wuS OVERLAYS 

C«T WRITE ROUTINE 

KEYBOARD READ HOUTInE 

uisk debug 

usu5e0 page 

cassette tape drivers 

cohmano Interpreter 

COMMAND Interpreter overlays 



END OF DOS 1,3 Entry points 



PAGE 



^:ST*/TXT 



DATAPOINT CONFIOBNTIAL lNfORH*TI0N * 8CE PABfc I 
LIST AN iNOexeO FILE PHOGRAH 



n 

12, 
13, 
14, 
19, 

le. 

17, 

le, 

19, 

20. 

21 

22. 

23, 

24, 

29, 

29, 

27, 

29, 

20< 

39, 

31 

32, 

33, 

34, 

39. 

3«. 

37, 

39, 

30, 

49, 

41 

42, 

43, 

44, 

49, 

49, 

47 

49, 

49, 

99, 

51. 

92, 

99, 

54, 

55, 

56, 

57 

58, 

59, 

60, 

61 

62, 

63, 

64, 



20004 
2003d 
20044; 
2(»1»» 
20113 
2idl54 
29191 
202^ 
292IJ 

299««i 
2»8«« 
29171 
291M 

2t3ac 
29««S 



294I7 
2«4C9 

29944 
2999C 
2»»S9 

29t«« 
299«t 

2(i»i« 

£ft»7t 
209>;74 
29»7^9 

29«0>t 
2t9«l 
299ft» 
209«9 

29911 
2»9I« 
2992te 

2)«623 
210925 

20927 
2993« 

2t(?633 
2ks635 
2063* 
2«)642 

2?6 4 5 
2w«5»; 

2^652 



Sll 
U4 
»11 
101 
«11 
191 
911 
124 

eu 

ui 
011 
in 

911 
123 
«il 
111 
ill 
Ml 



000 
111 
090 
119 

000 
940 
099 
117 



119 

000 
119 



117 



013 
123 
013 
940 
013 
129 
013 
117 
913 
129 
913 
104 
91^ 
129 



090 «13 

119 194 



099 

119 



013 

129 



013 

124 
013 
HI 
013 
117 
013 
049 
913 
191 
013 
109 
913 
122 
013 
10S 
023 
101 



023 
040 
023 
119 
029 
129 
023 
119 
923 
114 
923 
139 
023 
193 
023 
130 
023 
114 



29414 124 139 124 

All 999 913 013 



999 
l«9 

#«9 
974 
049 

199 

•99 
074 

#29 

335 
346 
996 
152 
066 
926 
974 
JSP 
8154 
320 
066 

e5 4 

262 

046 
110 

P66 

££24 
140 



000 099 040 

162 002 

199 099 003 307 

040 

036 036 040 

361 042 

179 307 

040 

003 



914 056 041 

149 002 

2i»l 056 0193 307 

377 

040 
263 041 

104 

202 31197 
122 

206 036 040 
361 042 

203 307 
060 

361 042 



SI6N0N 

NOXFNM 
NOSFNM 

xcsfnm 
iAOoev 

NOXFIi 
N09fXL 
XlOf 
A Of It 

TXT 

8UFFRP 
SUFFER 

* 
9TART 



6XTFH 



SET 

DC 
DC 
DC 
DC 
OC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
OC 

DC 



ML 

CALL 

HLA 

CP 

DE 

JTZ 

MLA 

CP 

LC 

LOH 

LEL 

ML 

CTZ 

MLA 

LC 

CP 

JTZ 

xr' 

LCA 

^LA 

XR 

ORC 

DE 

JFZ 

ML A 

SU 

JTC 



020000 

0}l,0i013a 1*023 

'LIST AN INDEXED FILE U1S019 

k)llr0fi«13f 11,023 

'AN INDEX FILE NAHe HU8T 6fc GIVEN,', 3 

011,0,013,11,023 

'A SOURCE FILE NAME MUST BE GIVEN. ',3 

011,0,013,11,023 

•TOO MANY FILE NAMES, ',3 

011,0,013,11,983 

'INVALID DEVICE, ',3 

011,0,013#1 1,023 

'INDEX FILE NOT FOUND, ',3 

011,0,013,11,023 

•SOURCE FILE NOT fOUNOt',3 

01 1 , 04 01 3 f 1 1 #08 9^923 

•INDEX FILE £0F.<,3 

011 f 01019, 923,983 

'INVALID FORMAT IN SOURCE FILE, 

»TXT» 



♦»3 



DC 011,0«013rll 

SK 91 



SIGNON 
DSPLYS 
*LFT*LF1*2 
I t 

NOXFNM 

ERROR 

LFT*LFi*10 

! t 

3 



TX T 

BLKTFR 
*LFT*LFl*13 

-I 
I I 

SETXOR 
•0' 

LFT*LF1*14 
»M' 

BAOOEV 

ERROR 

LFT*LF1*19 

'0' 

ERROR 



0I9PLAV THE SISNwON 

THERE MUST 9E AN INDEX FILE SPECIFIED 

ASSUME AN EXTENSIO;^ OF TXT IF NONE GIVEN 



see IF DRIVE SPECIFIED 
SEARCH ALL DRIVES IF NOT 



PAGE 



E 


8 


LI8TX/TX1 


r 


65, 


, 20655 


074 


004 




66. 


2f»657 


100 


361 


^42 


67, 


2^662 


320 






68, 


20663 


066 


201 


372 


69, 










70, 


20666 


066 


206 


307 


71, 


20671 


074 


040 




72. 


20673 


046 


105 


036 0419 


73, 


20677 


150 


361 


042 


74, 


20702 


066 


216 


3<«7 


75, 


20705 


074 


040 




76, 


20707 


026 


003 




fy^ 


20711 


335 






78, 


20712 


346 






79, 


20713 


066 


014 


056 041 


80. 


20717 


152 


143 


002 


81, 


20722 


066 


221 


056 003 307 


B2, 


20727 


026 


377 




83. 


20731 


074 


040 




84, 


20733 


190 


374 


041 


85, 


20736 


054 


104 




86, 


20740 


320 






87, 


20741 


066 


222 


307 


88, 


2B744 


054 


122 




89, 


20746 


262 






90. 


20747 


046 


206 


e36 040 


91. 


20753 


lie 


361 


042 


92, 


, 20756 


066 


223 


307 


93, 


. 20761 


024 


060 




94. 


, 20763 


140 


361 


042 


95, 


, 20766 


074 


004 




96, 


. 20770 


100 


361 


042 


97. 


, 20773 


320 






98, 


, 20774 


066 


221 


372 


99, 










100, 


\ 29777 


066 


226 


307 


101. 


, 21002 


054 


040 




102 


, 21004 


320 






103 


, P1005 


066 


236 


307 


104 


, 21»U? 


054 


04P 




105 


. 21012 


262 






106 


, 211^13 


320 






107 


, 21(^14 


P166 


24 1 


307 


108 


. 2H817 


.^54 


fl40 




lkl9 


. 21«21 


262 






110 


, 21t«22 


^46 


154 


V«36 040 


111 


, 21*«26 


110 


361 


(042 



OATAPOIiMT CONFIDENTIAL I'.FOW*' ATION • SEE PAGE 1 
LIST AN INDEXED FILE PROGRAM 



SETXOR 



SET80R 



CP 


4 


JFC 


EHROf« 


LCA 




MSC 


LFt*LFl*l3 


HUA 


LFT*LF2*2 


CP 


? 1 


DE 


nOSFnm 


JTZ 


ERROR 


MUA 


LFT+LF2+1*) 


CP 


1 t 


IC 


3 


LDM 




LEL 




HL 


TXT 


CT2 


BLKTFR 


HLA 


•LFT*LF2*13 


LC 


•1 


CP 


1 1 


JTZ 


SETSOR 


XR 


• o» 


UCA 




MLA 


LFT*LF2*14 


XR 


•P' 


ORC 




DE 


BADOEV 


JF2 


ERROR 


MLA 


LFT*LF2*1S 


9U 


I0I 


JTC 


ERROK 


CP 


4 


JFC 


ERROR 


LCA 




M8C 


LFT*LF2*13 


MLA 


Lf T+LF3+2 


XR 


1 1 


LCA 




MLA 


LFT*LF3*19 


XR 


1 1 


ORC 




LCA 




MLA 


LFT*LF3*13 


XR 


II 


ORC 




DE 


XCSFNM 


JFZ 


ERHOt< 



SAVE THE INDEX FILE DRIVE NUMBEH 
A SOURCE FILE MUST t>E SPECIFIED 

ASSUME EXTfeNSION OF TXT IF NONE SPECIFIED 



SEE IF A DRIVE IS SPECIFIED 
SEARCH ALL DRIV6S IF NONE GIVEN 



ELSE CHECK THE DRIVE SPECIFICATION 



SAVE THE SOURCE FILE DRIVE NUMBER 
NO OTHER FILE ShOULU BE SPECIFIED 



PATAPOINT CONFIDENTIAL iHfOnHAllQf* • SEC PAGE I 
PAGE 9 tISTX/TXT UI3T AN INDEXED FILE PROG«Af^ 

♦ 

L8 LFl 
327 MLC *LFT*LFl*13 TRY TO OPEN TmE INDEX FILE 



E 




tISTX/TXT 




112. 












U3. 


21031 


016 


020 






IM. 


21033 


066 


201 


096 


0«3 


U5. 


21041^ 


246 


166 


e36 


afc!3 


116. 


21044 


106 


066 


0«2 




117. 


21B47 


046 


233 


036 


040 


U8. 


21053 


140 


361 


042 




U». 


21096 


ei6 


040 






lae. 


21060 


066 


221 


856 


00 3 


121. 


21069 


046 


206 


036 


003 


133. 


21071 


106 


066 


0|)2 




ia9. 


21074 


046 


266 


096 


040 


1»4, 


2uei 


140 


361 


042 





327 



L8 


LFl 


MLC 


•LFT*LFl*13 


OE 


LFT*LF1*2 


CALL 


OPENl 


OE 


NOXFIL 


JTC 


ERROH 


LB 


LF2 


MLC 


♦LFT*LFa*l3 


OE 


LFT*LF2*2 


CALL 


OPENS 


OE 


N09fIL 


JTC 


ERROR 



TRY TO OPEN THE SOURCE FILE 



PACE 



E 19 


1 


,I8TX/TXT 




125. 








126. 


211^3 


016 020 




12?. 


21109 


106 113 


0U2 


128, 


2111t» 


016 020 




129. 


21112 


106 121 


002 


130. 


21115 


330 




131. 


21116 


106 121 


002 


132. 


21121 


340 




133. 


21122 


106 121 


002 


134. 


21125 


350 




135. 


21126 


260 




136. 


21127 


110 190 


042 


137. 


21132 


264 




13B. 


2 1 1 33 


110 190 


042 


139. 


21136 


303 




i*9. 


21137 


260 




Ml. 


21140 


190 346 


042 


142. 


21143 


074 009 




143. 


2U49 


190 103 


048 


144. 








145, 


21190 


070 




146, 


21191 


304 




147, 


21192 


024 002 




148. 


21194 


340 




M9. 


21155 


303 




isa. 


21156 


^34 06*0 




151. 


21l6i9 


330 




192. 


21161 


016 040 




193. 


21169 


106 110 


002 


194, 


21166 


106 113 


002 


155. 


21171 


060 




156. 


21172 


309 




197. 


21173 


066 222 


056 


198. 


212tAt« 


016 040 




199. 


21202 


106 121 


002 


I6tf. 


21205 


074 003 




161. 


21207 


150 359 


Ul 


162. 


21212 


066 023 


163, 


21216 


104 233 


042 


164. 








169. 








166. 








167. 


21221 


016 040 




168. 


21223 


106 121 


002 


169. 


21226 


074 003 




170. 


21230 


150 311 


042 


171, 


21233 


074 011 




172. 


21235 


190 323 


042 


173, 


21240 


370 




174. 


21241 


07 4 019 




175. 


21243 


150 254 


P!42 


176. 


21246 


106 011 


0(1? 


177. 


21251 


104 221 


042 


176. 









OATAPOINT CONFIDENTIAL InF0««AT10N • SEE PAGE I 
WIST AN INDEXED FILE PR06«Ah 



003 370 



041 



♦ 






6ETXR 


LB 


LFl 




CALL 


READ* 


UETXP 


LB 


LFl 




CALL 


GETS 




LOA 






CALL 


GET* 




LEA 






CALL 


GETS 




LMA 






ORA 






JFZ 


GET8R 




ORE 






JFZ 


GET8R 




LAD 






ORA 






JTZ 


EOJ 




CP 


9 




JTZ 


GETXR 


GETSR 


PUSH 
LAE 






SU 


2 




'ad 






5b 







LDA 






LB 


LF2 




CALL 


POSITS 




CALL 


READS 




POP 






LAH 






HSA 


•LFT*LP2*BUFA0R 




LB 


LF2 




CALL 


GETS 




CP 


3 




JTZ 


FILERR 




ML 


BUFFER 




JMP 


SAVCHR 


• 

, READ 


THE LOGICAL RECORD - 


GETSC 


LB 


LF2 




CALL 


GETS 




CP 


003 




JTZ 


PEOR 


SAVCHR 


CP 


kSU 




JTZ 


SPC«PR 




LMA 






CP 


^\5 




JTZ 


USPREC 




CALL 


INCHL 




jhP 


GETSC 



READ THE FIRST INDEX RECORD 

GET THE POINTERS FOK THfc SOURCE RECORD 



SAVE THE BUFFER POINTER 

TEST FOR PHYSICAL ENO»OFfiRECOKO 

NO 

TEST THE PHYSICAL RECORD POINTER 

NO 

IF THE MSP OF PMY8,REC,PTK, IS ZERO 

THEN THIS IS eNO»OF»lNOEX FILE 

IF THE MSP OF PMYS.RCC.PTR, IS THREE 
THEN THIS IS ENOtOF-lNOeX-PHVSICAL-RCCORO 

SAVE THE BUFFER POINTER 

BIAS THE PHYSICAL RECORD POINTER 



POSITION TO THE SOURCE RECORD 

READ THE SOURCE RECORD 
RETRIEVE THE BUFFER POINTER 
SAVE THE BUFFER POINTER 

READ THE SOURCE RECORD FIRST CHARACTER 

CATCH AKY ERROR 

INITIALIZE THE DISPLAY BUFFER POINTER 
ENTER NORMAL LOOP 



GET A BYTE 

CATCH END OF PHYSICAL KECOWU 

CATCH SPACE COMPRESSION 

ELSE STORE TmE CHARACTER 
CATCH END OF LOGICAL RECORD 
DISPLAY THE RECORD IF ALU IN 
ELSE aUMP THE BUFFER POINTER 
RESUME CHARACTER READING 



PACE 



e 11 


UlSlX/TXI 




I7y. 


21254 


dbt> 


t?l7 


i^56 !d41 


idii. 


2126/ 


\\cb 


102 


m^.2 


idl. 


212«i 


iS*)6 


341 




182. 


21265 


tl!40 






183. 


21266 


121 






184, 


21267 


300 






185, 


2127Z 


101 






186. 


21271 


«)50 






187. 


21272 


320 






188, 


21273 


«|44 


(1)10 




189. 


21275 


110 


263 


042 


190. 


21300 


302 






1»1. 


21301 


• 44 


004 




102. 


21303 


110 


151 


002 


les, 


21306 


104 


110 


042 


194, 










195, 


21311 


070 






196, 


21312 


01fi 


040 




197, 


21314 


106 


113 


ftki2 


198, 


21317 


060 






199, 


21320 


104 


221 


K!42 


2«»i9, 










2*?1. 


21323 


106 


121 


002 


202. 


21326 


ID36 


e4M 




2«'9, 


21330 


320 






204. 


. 21331 


373 






205. 


21332 


106 


011 


002 


2*^6. 


, 21335 


3M2 






207, 


, 21330 


024 


v<v91 




2«I8. 


, 21340 


110 


330 


i;42 


209, 


, 21343 


104 


221 


042 


210, 










211, 


[ 21346 


^4t> 


322 


036 040 


212, 


, 2135C 


10-* 


361 


P»42 


2ii 










3! ^ 


! 213t5 


V146 


3t^ 


V36 24i(! 


?ib 










?16 


\ 21361 


353 






217 


, i?l362 


364 






216 


, 21363 


l?6 


lt.2 


ir*2 


?19 


, 2136>' 


1^4 


151 


V-ttZ 


22^ 










221 


] 2if544 









OATAPUINT CONFIOENTIAU INFORMATION - SEt PAGt 1 
LIST AN iNOeXEO f 11^ PROCHAh 



OSPfiEC 


HL 


BUPF«P 




CALL 


DSPLV* 


DKWAIT 


DI 


>fJ341 




ex 


AOW 




NOP 






IN 






EI 






LCA 






NO 


«)lid 




JFZ 


OKhAIT 




LAC 






NO 


004 




JFZ 


EXlTi 




JMP 


GETXP 


PEQR 


PUSH 






LB 


LF2 




CALL 


REAO* 




POP 






J MP 


6ET&L 


SPCt<PR 


CALL 


&ETS 




to 


t f 


SPCMPL 


LCA 
LMO 






CALL 


INCHL 




LAC 






SU 


I 




JFZ 


8PCHPL 




JMP 


GETSC 


* 
kOJ 


OE 


XEOF 




J MP 


ERROR 


flLERR 


01 


8A0FIL 


ERKUK 


LLE 






CALL 


06PLV» 




JMP 


EXIT* 



POINT TO ftUi^FfcW SCREEN POl^TgicS 

pISPLAY IhE LOtilCL KECONO 

SEE IF THE t»lS»PLAV KEY IS DEPRESSED 



SAVE THE STATUS 

VESf (KAIT 

SEE IF ABORT 

YES 

6ET THE POINTER TO THfc NEXT RECORO 

SAVE THE BUFFER POINTERS 

REAO THE NEXT SOURCE PHYSICAL RECORO 

RESTORE Tn£ BUFFER POINTERS 
RESUHE CHARCTER reading 

GET THE SPACE COUNT 

SPACE 

SAVE THE SPACE COUNT 

PUT SPACE IN BUFFER 

BUMP THE BUFFER POINTER 

DECREMENT THE SPACE COUnT 

RESUME CHARACTER READING 



tND 



STAfeT 



AGE 12 


LISTX/TXT 




2162^6 


BADOtV 


*22 


6tl 


2^3Se 


SAUFIL 


• 50 


214 


011^3 


HL'<7FR 


*2aiA 


90 


Piaee4 


8L«N 


*96IA 




etieee 


BOOT» 


*9tA 




91199 


esps 


*52IA 




00016 


euFAOR 


*102IA 


197 


28423 


SUFFER 


• 36 


162 


22417 


8UFFRP 


• 99 


179 


I3eei9 


CA8A0S 


•1141* 




'AH?i2 


Chops 


• 49IA 




01B77 


CLOSEf 


♦ 421 A 




01044 


CLRIS 


• 22IA 




12400 


CHOAOi 


♦115IA 




14907 


CMOINT 


• 31IA 




\79^v^ 


COVAU* 


•116IA 




\Al9ii 


CSS 


• 19IA 




(.^20^6 


cso 


• 97IA 




W600» 


UEBADS 


•ii2IA 




i«ll5^ 


QEBUGl 


• 561 A 




^/<1022 


DECHL 


• 27IA 




21203 


OAwAlT 


• 181 


189 


.■t 1 J" t! V 


OnSAUS 


*1«B}A 




M^^0t?5 


>)MSPUN 


• eeiA 




.1 k^ t» / 4 


ihjspfn 


• 79IA 




11 yj ? 2 ri 


odsptk 


•dliA 




^lk?52 


OK> 


• 13IA 





DATAPOINT CONFXOENTIAU INFOHMATION • 8EE PACE I 
LIST AN INDEXED FIUE PHOGRAH 



90 



80 



OATAPOINT CONriOeNTlAU lNfOHHAT20»* • SEE PAGE I 

pact 13 LISTX/TXT LIST AN INDEXED PILE PROGRAM 



i^i;?6e 


OSKwAT 


*15IA 










iS54(?f 


IjSPAU* 


*U^.|A 










01162 


OSPLVS 


• 581 A 


39 


lUii) 


218 




21294 


ospwec 


175 


♦ 179 








i3l0l5S 


UmS 


*14tA 










21346 


EUJ 


141 


•211 








21361 


tl^ROR 


43 

124 


61 

212 


64 
• 216 


66 


73 


eusi 


EXITS 


*30IA 


192 


219 






205?! 


EXTFLl 


*44 










21399 


FILERR 


161 


•214 








011S1 


GETS 


*48f A 


129 


131 


133 


169 


01ii947 


GETNCH 


• 12IA 










01124 


GETR» 


*49tA 










21221 


GCTSC 


•107 


177 


199 


2«)9 




21l9(d 


GETSR 


136 


136 


• 145 






?Ul^ 


GtTXP 


• 120 


ltf3 








21123 


&tTX*< 


• 126 


143 








i^ 1 ?. 1 1 


INCHU 


• 2eiA 


176 


2Mb 






(^5572 


^ E Y A t) * 


•111 lA 










feill57 


^EYlNi 


• 57IA 










/^0(^yi 


L0t<AOS 


*1^7tA 










^00i?»^ 


IfV^ 


• 861 A 










f-i pi 2 It 


LFl 


«d7lA 
126 


4M 

128 


44 


51 


b7 


^^io4H) 


LF2 


* 8 P 1 A 
1^2 


7a 

J 57 


7 4 


Bl 
167 


B7 

19fc 


^«fe5C";'^ 


Ll- J 


• B^iA 


lfe)0 


it.i 


J>^7 





91 94 96 111 lie 



168 2I01 



62 68 113 n, 4 Mb 
92 98 Uy 12W ii;i 



DATAPOINT CONflDCNTXAL InFOKHATION - SEE PAGE 1 



PAGE 14 


LISTX/TXT 




LIST 


AN INDEX! 


:D FIUC F 


'ROSRAM 










01344 


LFT 


*d5lA 

87 
157 


40 

92 


44 
98 


51 

100 


57 
103 


62 
107 


68 
114 


70 
119 


74 
120 


81 
121 


SJl«7| 


UOAOS 


♦ 371 A 




















eiifiee 


LOAOXS 


• lllA 




















i00?tf? 


LRN 


*95IA 




















ia«et4 


LRNLIW 


* 1011 A 




















00012 


MAXLRN 


*ieeiA 




















(^1400 


«CR1 


*84IA 




















20266 


N08FIL 


*26 


123 


















20105 


N08FNM 


•10 


72 


















20233 


NOXFIL 


*24 


117 


















20036 


NOXFNM 


• 16 


42 


















01066 


OPENS 


♦ 361 A 


116 


122 
















9>4e00 


OVLADl 


♦109IA 




















00001 


PDN 


♦ 94 1 A 




















21311 


PEOP 


170 


♦199 


















0000^ 


PFH 


♦ 93IA 




















01110 


PCSIT» 


♦ 48IA 


153 


















i^l063 


P«EP» 


♦ 35iA 




















01105 


PROTE» 


♦ 44IA 




















^1127 


PUTS 


♦ 5e>tA 




















01132 


PUTkS 


♦ SUA 




















^31113 


HEADS 


• 46tA 


127 


154 


197 














t^et^ l*? 


ftlSCYU 


*9eiA 




















^0(^11 


klBSEC 


♦ 99tA 




















kllk)74 


fiONi 


ndBlk 




















-aipif-i 


i^U^XJi 


♦ 10IA 





















'AGi; 1 


15 


LISTX/TXT 




21232 


SAVCHR 


163 


♦171 


0<flt)27 


SDFLAG 


«82lA 




0003« 


SDNR 


•831 A 




«lfr^41 


StTI* 


*2nA 




2itfy74 


SETSOR 


84 


• 98 


20063 


SCTXDR 


54 


• 68 


zaedid 


SIGNON 


*14 


38 


21330 


SPCMPt 


*203 


208 


21323 


SPCHPR 


172 


• 201 


20S44 


STAWT 


*38 


221 


1H8117 


Ty»F» 


• 651 A 




10^61 


TCMK» 


• 75IA 




lieti45 


TFMH» 


• 71IA 




10090 


TFMwf 


• 721* 




01036 


TP» 


• 201 A 




l000e 


TPBOfS 


•62IA 




10005 


TpeoFi 


*63:a 




10?31 


TSS 


• 67 I A 




t^ll46 


TWAP» 


• 29IA- 




10034 


TWEADS 


.*6BIA 




11^ 91 J 2 


Tw«* 


• 64 t A 




1^1053 


TTWAPi 


• 73IA 




li?i(^37 


T«.i 


•6SJ A 




l^V^bb 


T»^AIT» 


♦ 74 J A 




11^*^24 


T«e!LK» 


• b6 t A 




10W42 


Tw.*IT* 


♦ 7 1^ » A 




20414 


It I 


• 43 


49 



OATAPOINT COnPIOENTIAU INFORMATION • SEE PAGfe 1 
LIST AN IN06XE0 FILE PROCRAf^ 



7 9 



ASe 16 


LISTX/ 


TXT 




074«e 


UNPADS 




♦ U3IA 




aiU6 


-Riie* 




♦ 47IA 




211)154 


XC5FNH 




*20 


ue 


20322 


XEOF 




«28 


2U 


00017 


XXXXXX 




*ie9iA 





OATAPDINT CONPIOCNTIAI. iNFORf^ATION • SCC PAlili I 
LIST AK iNOexCO FILE PROGRAM 



liei LABELS U9C0 



28.8 EXAMPLE OF SOPHISTICATED ASSEMBLER 

LANGUAGE LINKAGE TO SORT 



This subsection gives a detailed example of the use of the assembler language 
linkage method in SORT. The example is in the form of the complete program 
SORTTEST, described in 28.3.12 of the SORT Section, and extensively described in 
the comments of the program itself. 

A modified version of the SORTTEST program produced the SORT OPTIONS 
COMBINATIONS SAMPLE LIST which is listed In subtectlon 28.9. 

The SORTTEST program was the system controller program which used the 
SORT utility to produce the sorted output sample files listed in subsection 28.10. 



28-32 PART III SYSTEM COMMANDS 



PAGe I SORTTEST/TXT SORT OPTIONS C0M8INATl0f*9 GtNEHATIflN PROGKAH 

DOS ASSit^Btew 5,1 663 LABELS 

CONFIDENTIAL PRt)P« Ifet aHY INFORHATIDN 

THIS ITEH IS THE PROP£«TV OF OATaPOInT CORPOHATION, S*N ANTONIO, TEXAS* AnQ CONTAINS CO?<F IOEnTI AL A^O 
TRADE SECRET INfaRMATIQN. THIS ITEM MAY NOT 8E TRAnSFEhREO FROM THE CUSTODY OR CONTROL OF OATAPOINT EXCEPT 
AS AUTHORIZED BY OATAPOINT AND THEN ONLY BY «AY OF LOAN FOR LIMITED PURPOSES. IT MUST NOT BE REPRODUCEU 
ll IhJlE Jr IN PAR? AnS MUST BE RETURNED TO OATaPOInT UPON KEOUEST AND IN ALL EVENTS UPON COMPLETION OF 
THE PURPOSE OF THE LOAN, 



nEIT 
FOR SUCH 
OATAPOINT, 



mER THIS ITE»< NOR THE INFORMATION IT CONTAINS MAY BE USED OR DISCLOSED TO PERSONS NOT HAVING A NEED 
USE UH DISCLOSURE CONSISTENT WITH THE PURPOSE OF THE LOAN, WITHOUT THE PRIOR WRITTEN CONSENT Of 



PA&E 2 



50RTTC8T/TXT 



D4TAP0INT CONFIOtNTUL ISFORHATION • SEE P*GE I 
SORT OPTIONS COMBINATIONS CENfeRATION PROGRAM 



Inclusion ai uos/ept 



PAGfe 



SU^<TTt&T/TXT 



OATAPOINT CONFIDENTIAL IfifOfinkllQH • SEE PASE I 

SORT UPTIOMS COMBINATIONS &t».EWATION PROGRAM 



1. 
2. 
3. 
4, 

5. 
6, 
7. 

e. 

9. 

u. 

12. 
13, 
14. 
19. 
16. 
17. 
18. 
19. 
20. 
21. 
22. 
23. 
24. 
25. 
26. 
27. 
28. 
26. 

3e. 

31, 
32. 
33. 
34, 

o5, 
3«>w 
37. 

38, 
39, 
A», 
41. 
42. 
43. 
44, 
45, 
46. 
47, 

4b, 

49. 

51, 

52, 
53. 
54. 



PROGRAM TO GtNERATE C0«8IN*T1CnS Of OPTIONS l*OK SORT , 

THIS PROGHAH GENERATES ALL MAJOR COHeiNATIONS OF OPTIONS USEABLE 
IN SORT , 0BVI0U8LT IT IS MOT FEASIBLE OR 0ESXRA8LE TO ATTEMPT 
TO GENERATE AND TEST ALL POSSIBLE COMBINATIONS OF OPTIONS ANQ KEY 
FIELDS THAT COULD 8E "AnolEU BY SORT, 

IN THE CONFIfiURATION OF TMg PROGRAM IN THIS LISTING THE PROG«AM 
GENERATES ONLY TmE PORTION OF THE PARAMETER STRING AFTER ThE SEMICOLON 
IN THE INITIAL SORT PARAMETER STRING, AND APPENDS THAT PuRTlON OF TME 
PARAMETER STRING TO TwE BASIC PARAMETER STRInGI 

SORT INFILCIOR1#OUTFIL£»OR2»IO»0» 

LOADED WITH THE FR06RA» INTO MCRS. IF AN OUTPUT LIMITATION STRING 
MOULD BE REQUIRED tt TOO 2S GENERATED AND A POINTER TO IT IS PLACED 
IN THE PARAMETER TABLE, IF A MAROCOPY OUTPUT HEADING STRING WOULD 
BE REOUIRCD A POrf^TCR TO IT 18 ALSO PLACED IN THE PARAMETER TABLE. 

THE PROGRAM CONSISTS OF THREE MODULES I SORT TEST CONTROL MODULE, 
SORT OPTIONS GENERATION MODULE, AND SORT INITIALIZATION MODULE, 

THE SORT TEST CONTROL MODULE RESIDES IN THE RESERVED MEMORY AREA OF 
THE SORT UTILITY WHgRE IT "ILl. NOT BE OVERLAYED OR DESTROYED BY SORT, 
THE CONTROL MODULE HOtaS THE VARIOUS CHOUNTERS, POINTERS, CONSTANTS, 
LINKAGE DATA AREAS kHO LINKAGE CODE FOR LOADING AND LINKING TO SORT AND 
FOR RELOADING THE SORT TEST PROGRAM FOR RE-ENTRY, 

THE ENTIRE SORRREST/CMO PROGRAM IS RE-LOAOED AT TME tNO OF EACH SOrtT, 
BUT FIVE VITAL BYTES THAT ARE COUNTERS OR POINTERS ARE NOT OVERLAYED BY 
RELOADING, THE BYTES ARE INITIALIZED DURING THE FORST SORTTEST/CMO 
PROGRAM EXECUTION and gPOATED BY SUCCESSIVE HE-EXECUTIONS OF THE SORT 
OPTION GENERATION MODULE. 

THE SORT OPTIONS GENERATION MODULE IS THE MODULE EXECUTED AFTER fcACH 
SORT ANP UPDATES 1 hE VfilO'JS POIn?£RS AND COUNTERS; GENERATES THE 
HAHAMETER STRING OPTIO'* VARIATIONS AND, «HfcN REQUIRED, TnE LIMITATION 
STRINGS AND VARIATIONS AnU T«E haROCOPY OUTPUT HEADING STRING, 

THf SORT INITIALIA2ATIDK MODULE PfeKFORnS RAThEW fc«ltNSlVE INIT I ALU AT IUn 
CHUWES F0'< The S'.!»*T TESTl^i,, iNCLUDlNGt 



1. 
2, 
3. 
4, 
5. 
6, 

7. 

8, 

9. 



IMTIAHZES The PaRAH£T£H generation BYTES, 

MAKES SURE fHt SORTTESt/CMD PROGRAM ITSELF IS U^ DiHVfc n. 

CHECKS TO MAKE SUKfc U-^IVES \ AND 2 ARE ON-LIME. 

MAKES Sure THE SO«T UTILITV (SOkT/CmO AND SOHT/OVl) IS ON 

DETERMINES FWO?- OPERATOR THAT DRIVES 1 ANU ii HOLD SCt^ATCH 

MAKES SUHE ALU TEST PILES (SPECIHED AT SUKTTfcST ASStM^UY 



oWlvE fd, 
PACKS, 

Tl^t) Ar<fc 



UN DRIVE kJ, 

KILLS ALL FILES AND utALLOCATES ALL SPACE EXCEPT CYlInDER ZtRU UN 

DRIVES I ANU 2, 

npENS thf i\PuT/txt 

EXITS TO &Eju£NT1al 
GENERATIO-N" «Oi'Uu£, 



f- ILE ON Df<ivfe 1, SETS 
I -PUT FILE GEnEWATIOKi 



FILE SUE TO 9696 RECORuS, 
HOUTlwf- Ii^ SDHT OPTIONS 



PAGE 



SORTTEST/TXT 



DATAPOINT CONFIDENTIAL InI^O«'*aT I0»* - SEE PAB6 1 
SORT OPTIONS COMBINATIONS SEfttERATlON P«OC«AM 



S5. 
56, 
57. 

Sb, 
59. 

ei. 

62. 
63, 
64, 
65. 
66. 

o;. 

66. 
69. 

79, 

ri, 

72. 
71, 
74, 
75. 
76. 
77. 
78. 
73. 
6k9. 
SI. 
62. 
83. 
84. 
«5, 
86. 
87. 

an, 

69, 

v*». 

91. 

92. 
9i. 

94, 
95, 
96. 
4*7. 
38. 

l^C. 
l^l. 
W2. 



THfc APPWUACH rn OPTIO*. SfcLECTION 13 HtTHODlCAL Ab OPPOSEU TO RANQOn, 
THE OPTIONS TO BE INCLuOEu I*- aOTM THE INITIAL PAKAMfcTER STRlNfr anu In 
THfc LI*^ITATIUN STHINt ARE SELECTED BY THE BIT PATTERNS IN ONt 6YTE TO 
-HICM IS ADDED OWE UnTR A Ll'^IT IS REACHEU, THE LIHIT IS ZERO t»..<AP- 
AHOUND) IN THE CASE UT ThE BYTES FOR THE INITIAL PARAH£Tfc» STRING ANg 
0Zia FOR THE LIMITATION STWInG, 

THE SIGNIFICANCE 01- Tnt BITS IN THfc BYTES IS AS f-ULUOWS: 



PARAMETEH STRING BYTEI 



A7 


« 






O 











A6 









« 





AS 

9 





« 









A4 

























A3 

« 


« 






A«l 



A2 Ai 

0.«.-« — C0ALLAT1N& SEixUENCE 
i$«ASCENDlN6 

« l«0tSCEN0IN6 

0— SPECIAL OUTPUT SPECIFICATION 
0»»NO SPECIAL OUTPUT 
eUTAG FILE 

U»LIHITATION STRING, HO PRINT 
U»UXMITATION STRING AND PRINT 
O—.KCY GROUP INDICATOR 

aiNO PRIMARY/SECONOARY SPECIFICATION 
isUSe PRIHARY/SECQNDARY SPECIFICATION 
— -a, PRIMARY SPECIFICATION 

l«S£CONOAKY SPECIUCATION 
0— -HEADER KEY EVALUATION TYPEl 
^•EQUIVALENCE 
1«ImEUUIVALENCE 
0— -SORT KEY DIHECTIONI 
^■FOR«ARD SORT KEY 
laBACKHARD SORT KEY 
0— OUTPUT FILE FORMAT 

^■COMPRESSEO SYMBOLIC (SEQUENTIAL) 
1«IN0EXEU RfCOHQS 



LIMITATION STRING 8VTEI 



a7 



A6 
.0-, 



A5 
.0-< 



A4 
• 



NOT uSEO---« 



A3 kZ Al Atf 

© 0----0 

©"-OUTPUT iNOICATOHSa 
t4l0aFORMARD POINTERS 

»^l»BACKt«AND POINTERS 

lt(J»ASCIl KECUffO POINTER 

O — -0 llMASCII STHiNG 

— CONCITIONAL OUTPUT SPEC IF IC AT lOvi 
8M«UNCUN0IT10nAL OUTPUT 

0i«usiN6 curwent header 

lfc5»USlN6 RELf fcwUlVALENCE 
U«U8InG REL» iNtyulVALfcNCE 



PAGt 



3UkT rtST/TXT 



UATAPOINT CD.NFIOENTXAL INFORMATION - SEE PAGE I 
SORT OPTIONS COMBINATIONS GEnEWaTION PRQGRAw 



li^3. 




l^b. 




1. 


A 


2. 


A 


3. 


A 


*, 


A 


5, 


A 


6. 


A 


7. 


A 


e. 


A 


9. 


A (»18)«« 


t^. 


A »1^0d 


u. 


A (^i0He 


12. 


A liiidA? 


U, 


A 0ies2 


i*. 


A (91095 


15. 


A P)1060 


16» 


A 


17. 


A 


J. 8. 


A 


19. 


A a 1033 


2e>. 


A 01036 


21. 


A 01>$41 


22. 


A ($1044 


2d. 


A 


24. 


A 


25, 


A 


26, 


A (91011 


27. 


A 01^22 


26. 


A 01143 


29. 


A 0JM6 


v^KJ, 


A t^llSl 


Ai, 


A 14r.fcJ7 


32, 


A 


33. 


A 


3^. 


A 


35, 


A vU.63 


30. 


A filidbb 


37, 


A t«14?7l 


3H, 


A 1/1 1/.? 4 


3S, 


A 


4^, 


A 


41. 


A 


42, 


A / J i-*. 7 7 


O. 


A /IU>2 


AA, 


A f . U ki 5 


■i'b. 


A ^' 11 1 /■ 


it. 


A 1/1113 


«7. 


A y3111«> 


^fc>. 


A /I 121 


4<*. 


A i' 1 1 2 4 


bv^. 


A iM127 


31 , 


A /U32 


5;?. 


A i^\ 135 



INC DOb/EPT INCLUDE THt UDS gNTKY PQI^T^j 
THIS FILE CONTAINS THE QUS 1,3 ENTRY POINTS 



LOADER ROUTINES 



ftOOTi 


EQU 


vnaidifl 


KUNXS 


eou 


01003 


UOADXt 


EOU 


01000 


CETNCH 


EOU 


a 1 04> 


OHi 


EQU 


01IS9S 


OMt 


EOU 


01099 


OSKWAT 


EOU 


01060 



HELOAO THE OPERATING SYSTEH 

LOAD AftP RUN A FZUE BY NUM8ER 

LOAD A FILE BY NUMBER 

GET THE NEXT DISK BUFFER BYTE 

READ A SECTOR InTO THE DISK BuFFEH 

WRITE A SECTOR FROH THE DISK BUFFER 

MAXT FOR DISK READY 



TIME»CRITICAL SCHEDULINS ROUTINES 



CSf EOU («1«33 

TP» EQU 1^1036 

3ETIS EQU «»1M1 

CLRIJ EOU ^1044 



CHAMCe PROCESS STATE 

TERMINATE PROCESS 

INITIATE A TIME-CRITICAL PROCESS 

TERMINATE A TIMEwCRlTlCAL PROCESS 



GENERALIZED PROCESSING ROUTINES 



INCHL 


EQU 


^ 1 if^ 1 1 


OECHL 


EQU 


011} 2 2 


BLKTFH 


EOU 


Ml 143 


TRAP* 


EQU 


i«1146 


EXIT* 


EQU 


631151 


CMDINT 


EQU 


«9145<97 



increment hl 

decrement hl 

transfer a block of memory 

set a disk error condition trap 

close all files and reload oos 

Interpret mcr* as a command 



SYMBOLIC flLF HANDLING WOUTI^^ES 



PREP* tOU t6l;^63 

OPENS E«U 014166 

LOADS EQU «ie71 

RUKS EOU y»lv^74 



UPEn or CREATE A FILE 
OFfcN AN EXISTING FILE 
LOAD A FiLfe BY NAME 
LUAO AND RUN A FILE BY NAME 



LnsiCAL FILE MANULINC WOUTINtS 



CLUSfc* 


E«u 


i^ 1 tfl 7 7 


CHOP* 


fcUU 


«Uv5« 


PKOTE?- 


tuu 


^11^5 


MUSITS 


EQU 


«^U1^ 


^EADS 


EQU 


''1113 


WRITE* 


EQU 


» 1 1 1 6 


GETS 


EOU 


^1121 


UtTRik 


EOU 


«U24 


PUT* 


EQU 


i^ll27 


Pl'TRS 


EQU 


^1132 


ttSP* 


EQU 


^1135 



CLOiE A FILE 

JELETE SPACE IN A FILE 

CHANGE THE PROTECTION Qn A FILE 

HOSITtON TO A RECORD ^IThIn A FRfc 

«£Au A «ECORO InTU TMfc BUFFER 

wWllE A RECORD FROM Tm£ BUFFER 

GET The next buffer BYTE 

GET AN INDEXED BUFFER BYTE 

STOkE I^TU THE NEXT BUFFER POilTlUN 

STUHE IMU AN iNUEXtU BUFFER POSITION 

BACKSPACE ONE RECORD 



PAG£ 



SOHTTEST/TXT 



OATAPOINT CONFIoe^iTlAl. INFORMATION - SEE PAGE I 
SORT OPTIONS COHBINATIOnS GENERATION PKOGRAM 



53, 


A 


S4. 


A 


35. 


A 


56. 


A eii54 


57. 


A 01157 


58. 


A 4^1162 


59. 


A 


eii'. 


A 


61. 


A 


62. 


A H4eil?f 


63, 


A IkDev^d 


64. 


A ldtt.l2 


65. 


A lBfcl7 


66, 


A li»024 


67. 


A 10031 


68. 


A 1196)34 


69. 


A l«9e37 


7/. 


A Ii9e42 


71. 


A i«te49 


72. 


A 1099P 


73. 


A 1(^059 


7«. 


A 10^96 


75. 


A 10061 


76. 


A 


/7. 


A 


78. 


A 


79. 


A ^3^24 


6it). 


A J4Pi«05 


ei. 


A i9«9l}26 


82. 


A 00027 


B3. 


A 00030 


84, 


A 011400 


85, 


A 01544 


86. 


A 00000 


87. 


A 00020 


88. 


A 00040 


89. 


A 00060 


9^*. 


A 


91. 


A 


92. 


A 


93. 


4 v000r 


9^. 


A PI0001 


9?. 


A V^/-^'<2 


9n. 


A V- / e' 4 


97. 


A k^*^0eb 


93. 


A y. k« f n* 


9'4, 


A Irti^V?! 1 


Iv--', 


A /l^/12 


101 , 


A */»(»0l4 


1/''. 


A ki/»!lb 


1 - ^ . 


A / f ^ 1 ; 


l*''-!. 


A 


1^1, 


A 


U- r . 


A 



KEYBOARD AND OISPUAt WOuTIsEi 



OEBUU* ECU 
KEYINS ECU 
OSPLY* E'JU 



01154 
1C1157 
^1162 



Ef-TgR THE DteUliGlNG HOUTINE 
OBTAIN A LINE FROM Tnfc nEYdQAwb 
DISPLAY A LINE ON TmE screen 



CASSETTE TAPE HAnDuIng ROUU^ES 



TPbCF* 


EQU 


^10000 


POSIT 


TPEOFS 


EUU 


010005 


POSIT 


TRt*> 


EOU 


010012 


PMYSI 


TBSP» 


EOU 


010017 


PMtSl 


Ti^BLKS 


EOU 


(S10024 


»«RITE 


TRS 


EQU 


010031 


READ 


TREADS 


EQU 


010034 


TRS A 


Tw» 


EQU 


010037 


WRITE 


Ti*RIT» 


EOU 


010042 


Twj A 


TFMRS 


EOU 


010045 


READ 


TFf4*$ 


EOU 


010090 


«RITC 


T TRAPS 


EOU 


^10093 


SET A 


TWAITS 


EOU 


4^10096 


I-AIT 


TCMK» 


EQU 


010061 


GET I 



INTERNAL OOS t:iUIVALtNCES 



D05PFN 


EQU 


^40004 


UOSPON 


EQU 


0ib05 


OOSPTR 


EOU 


00026 


SDFLAG 


EQU 


00027 


5DNR 


EQU 


00030 


«CR» 


EOU 


01400 


LFT 


EOU 


01944 


LF0 


EOU 


0<4 


LFl 


EOU 


1<4 


LF2 


EOU 


2<4 


LF3 


EQU 


344 



ION TO THE BEGINNING Of A FILE 
ION TO THE ENO OF A FILE 
CALLT REMIND A CASSETTE 
CALLY BACKSPACE ONE HECOHO 

AN UNFORMATTED BLOC^ 
A NUMERIC CTOS RECORU 
ND WAIT FOR LAST CHARACTER 

A NUHbRIC CTOS RECORD 
NO WAIT FOR LAST CHARACTER 
THE NEXT FILE MARKER RECORD 

A FILE MARKER RECORD 

CASSETTE ERROR TRAP 
FOR I/O COMPLETION 
/O STATUS 



PFN FOR USE BY OR* ANC* Uw» 
PON FOR USE BY OKS AND l,mi 
BUFPTR USED BY GETNCH 
SuB-OIRECTORY CXISTANCE FLAG 
SUB-DIRECTORY NUMBERS (1 PER DRIVE) 
HUNITQR COMMUNICATION REGION 
LOGICAL FILE TABLE 
LOGICAL FILE #0 
LOGICAL FILE »l 
LOGICAL FILE «2 
LOGICAL FILE #3 



LOGICAL FILE TABLE OtSCRIPTION 



PFN 


EQU 


•« 


PDN 


EOU 


1 


LRN 


EOU 


2 


liLR^ 


EUU 


A 


LSD 


EQU 


b 


HIbCYL 


EOU 


6 


HiaSEC 


EQU 


9 


MAXLRf" 


EOU 


l<t 


LRNLIM 


EUU 


12 


HUFADK 


EUU 


14 


XXXXJfJi 


E'-iU 


15 



tl) PHYSICAL FILE NUMBER 

tl) PHYSICAL DRIVE NUMBER AND PKOTECTIOn 

C2) NEXT LRN TO BE DEALT ««ITh 

C2) FIRST LRN WITHIN CUKRtNl SEGMENT 

(2) CURRENT SEGMENT DESCRIPTOR 

(1) CYLINDER CONTAINING Th£ RIB 

(1) SECTOR CONTAINING THt RIB 
C2) LARGEST LRN REFtHtNCEO 

(2) LARGEST LRN ALLOwfcO 

CI) CURRENT CONTROLLER BUFFER ADDRESS 

U) NOT USFd 



DOS 1,3 MEMORY ►capping 



PAGE 



SOKTTEST/TXT 



OATAPOINT CONFIDENTIAU INFORMATION " SEC PAG6 I 

SORT 0PT10N& COf^BINATIDNS SfeNt«*TIDv P«OG«AM 



1<^7.A 


io/v*vi^ 










l^^S.A 


t' liA^'^ 










1/9, A 


i^4{"0V' 










U '^ , A 


(^ ft 4 H «?> 










in, A 


ir'5&72 










112. A 


!^6^0k9 










113. A 


<A74\?V< 










114, A 


IkJWkikO 










lis, A 


)24i)e< 










116. A 


I7?eii 










117. A 












118. A 












ia7. 


&1011 










106. 












Iii99. 












110, 












Ul. 












112. 












113. 












114. 












115. 












116. 












117. 












118. 












119. 












120. 












121. 












122. 












123. 


014H0 










124. 


0l4e(« 


123 


117 


122 


124 


125. 


/1441 










126. 












147. 


.'6144 










129. 












I29r 


? M 4 4 










13^». 


e6l4S 










131. 


11 6 1 4 b 










132. 


t?6l47 










133. 


fcblSK' 










13«J. 


t?5l51 










135. 












136. 


^-,0 152 


0^0 


BeVK 






137, 


t?6l54 


^at^o" 


//t* 






138, 


e/61&fc 


311 


^\4 






139, 












14fe?, 


^^ b 1 6 / 


k347 


122 


R^5 


lv'3 


Ml, 












M2. 


/oiJll 


lid4 


1 14 


Hi* 


12/ 


M3, 












J «d , 


u: r> 2 7 k" 


^26 


Kt^ii^ 






145, 


^■b2Ti 


332 








14h, 


^h27i 


366 


147 


I'Sfe 


v514 


147. 


1/ «? 3 1(^ yi 


If 6 


V471 


t^tig 




I4fc. 


/, b 3 SI .6 


ii7(? 









idGb 



347 



LOHAD* 


IQU 


k:l»i^««i!? 


D0SA04 


EOO 


'>l01«v)0 


OVLADS 


EQU 


ia«l40t!)M 


DSPAD* 


ecu 


005400 


KeVAOS 


eou 


«3f^&&72 


OEBAO* 


EQU 


«:)060(Ak> 


UNPA05 


EQU 


i«iw74ii0 


CASAOS 


eou 


^lfc)00ld 


CMOADS 


EQU 


<^124id0 


COVAOft 


EQU 


0170ifl(» 



tOS RESIDENT 

DOS OVEffUAYS 

CRT WRITE ROUTINE 

^EfoOARD ^'EAO kOuTINE 

DI&* DEBUG 

u^USEO PAGE 

CASSETTE TAPE DKIVEHS 

COMrtANO INTE^PHETER 

CDwwA(^D InTERPKETEH OVEHUAYS 



, END OF DOS 1,3 ENTRY POINTS 

INCHLS eou i«l*»M 

• 
*************** 



SORT 



TEST 



**•**••* 



C W T H i. 



«*•**«**** 



MODULE 



THIS CODE IS LOAOEO INTO THE RCJEBVEO MEHORY AREA Of THE SORT UTILITY 
WHERE IT WILL NOT SE OVCRLAVEO OR OfSTROYEO »V SORT, TMJS COOE HOLDS 
THE VARIOUS COUNTERS, POI>*TERS, CONSTANTS, LlNKAftE DATA AREAS AND 
LINKAGE CODE FOR LOADING AND LINKING TO SORT ANO FOR RELOADING THE 
SORT TEST PROGRAH FOR RE-ENTRY, 



, HCR* PARAMETER STRING INITIALIZATION: 

6 £ w HP M A 

DC 'SORT INFlLE:uRlfOuTf ILEIUR2, tORifil ' 
PRrtOPS SK ^ 



PR.MFLG 
LI"'? LG 
pNTPTR 
SHTPFN 
TSTPf-N 
CIFLG 

PTABLE 



LIHST(< 

HtuiNG 
SRTlnk 



SET 

sx 

SK 

SK 
SK 

5k 

DA 

DA 
DA 

oc 

DC 

LC 

LOC 
-^LE 
CALL 

PUSH 



16 6 1 4 4 

1 
1 

1 
1 
1 

1 



WE 1 ijKtvi 



•>« »RfcCURu-> « 



'ULHP5«Hll-2.* 



♦SR7PFN 
LOAD* 



LOCATE IN RESERVEH MEHpRT AK£a» 

PARikHETtP STRING OPTION FLAGS 
Li^IT^TlOK STf,'lK-6 OPtlO'"' FLAGS 
FILE NAME TABLE POINTED 
SORt/c-IU P^-YSICAL FILE ^^.ufbER 
SDf'TTEST/C^'D PHYSICAL FILE NUMBER 
I^ntKED FILE GENERATION S»<nCH 
PARA'^ETfcR TABLE FOR SDRT uINKaGEJ 
Ll^ITATIO^• STRING AQOHESS CASSUME NONE) 
"AROCOPY HtAOINii SThIKG AUORESS (aSSUI^E NUNt) 
SQRT £XIT ADDRESS 

tlf^jTATIOK STRlNGi l&AKPLE MAXIMUM SI^E) 
/5«P,*' * ' , l-6»',«!15 
"*«uCQPY HEADING SThlNbJ iSAMpLt MAXl^.U'^ SUtJ 

«i'WECDHU'-> «'/SxP,«»' « ' , l-6tr) ' , 1^15 
LlNKA&E TO SORT: 

LOAD THE SC*<T UTILITY FKOm URIVE ZERO 
USE The PFn 



LINA TO The sort 



OATAPOINT CONPIDENTIaU I'JFOHkaTION - SEE PAGE 1 



AGE 8 




ao««Ti 


resT^ 


CTXT 




SORT 


IPTIONI 


i COMBIN 


149. 


0631^4 


1966 


132 


056 


014 




HL 


PTAbLE 


15«. 


k<631ti 


04)7 










RET 




151. 












t 






192. 


MftJll 


d26 


d^^ 






WETURN 


LC 


^ 


153. 


t'CSU 


332 










(.DC 




154, 


1^6314 


1*66 


19k> 


»56 


^14 347 




HLE 


•TSTPFN 


195. 


»6321 


ie6 


071 


?«2 






CALL 


LOAD* 



LINKAGE F«UW 50KTI 

»t-LOAO THE SOHT TEST PiyOG*<AH 

USE THE Ffn 



PAUfe 



S0KTTE5T/TXT 



OATAPQINT CONFIDENTIAL INFORMATION • 8tE PAGE 1 
SORT OPTIONS COMBINATIONS &£Nfe»ATJON PROGWAM 



156. 














157, 














156, 














159, 














16a, 














161. 














162. 














163. 














164. 














165. 














166. 














167, 


M6924 


066 


144 


056 


014 


907 


166, 


<^633i 


260 










169. 


^6332 


150 


364 


016 






170, 


06399 


066 


144 


096 


014 


307 


171, 


00342 


910 










178, 


$96343 


066 


041 


096_ 


009 




173. 


96347 


044 


001 








174, 


ei695l 


150 


962 


014 






17S, 


06994 


026 


104 








176, 


(96996 


372 










177, 


H6997 


106 


011 


002 






178, 














170, 


e6362 


301 










ld0« 


t()6369 


044 


200 








181, 


06965 


150 


043 


015 






162, 


i9637«i 


070 










169, 


06971 


066 


151 


056 


014 


307 


184, 


e6976 


260 










185, 


06977 


110 


021 


015 






166, 


«764tf2 


006 


377 








187, 


^6404 


066 


151 


e56 


014 


370 


168, 


P64U 


106 


304 


017 






189, 


, C)C414 


066 


144 


056 


014 


317 


I9e. 


, ^16421 


063 










191, 


, ^6422 


02C 


111 








192 


, ti6424 


372 










193 


, 4^6425 


106 


011 


002 






194 


. ^643^ 


301 










195 


, V16431 


044 


006 








196 


, ^e-^bAii 


074 


0',32 








197 


^6435 


150 


104 


»rl6 






\9f^ 


, / b 4 4 '3 


\\,:A 


112 


kilS 







*************************************** 

* ♦ 

* SORT 0PTIU^5 GENeXATlON mqoulE • 

* * 

* THIS MODULfc IS LOADED ANU feXECUTEO ><iTM THE INITIAL PROGRAM LOAD AND * 

* RE-LOAOeO ANtr EXECUTED AfT£M EACM SORT, UNTIL ALL SORT OPTIONS HAVE * 

* BEEN GENERATED FOR ALL 0/ THE FILES IN THE FILE name TaBuE, * 

* • 

* 



GETAO 



66TCI 



SETIKX 



MLA 
OR A 

jtz 

HLA 
LBA 
HL 
NO 

JTZ 
LC 

LMC 
CALL 

LAS 

NO 

JTZ 

PUSH 

HLA 

OR A 

JFZ 

LA 

MSA 

CALL 

MtB 

POP- 

LC 

LMC 

CALL 

LAP 

ND 

CP 
JTZ 

JMP 



♦PRMFLS 

NXTFiW 
•PRMFL6 

PR MOPS 
I 

CETCI 
»0» 

INCHL* 



l<7 

GET SOS 

*CIFLG 

SETINX 

•I 
•CIFLG 

CVTINX 
*PkMFLB 

'I« 

INCML* 

J«l 
1*1 

SETTAG 

Sf TKG 



SEE If ALL OPTIONS GENERATED FOR FILE 

YES 

frET THE PARAMETER FLAGS BYTE 

SAVE THE OPTION FLA6S IN B 

INITIALIZE THE PARAHETEH STRING POINTER 

GET ASCENDIN6/0ESCC^r0ING 

ASSUME A8CEN0ING 

ELSE PUT OfSCENOlNG 



SET COMPRESSED/INDEXED 

ASSUME COHPkCSSED 

*SAVE THE PARAMETER STING ADDRESS 

FIRST TIME NOP 

JUMP IF NOT FIRST TIME 
TURN OFF THE FIRST TIME NOP 

COPT NAMED FILE TO INDEXED INPUT FILE 
RESTOftS TME PARAMTER FLAGS BTTE 
• PtSTORE ThE PAWAMETtH STRli^G AODHtSS 
&F,T The I>'0£XEt; FLMtJ 



»*ITH THE INDEXED FORMAT 

NO LIMITATION STRING CA^ bt SPfcClPILO 

TAG FILt SPtClFlCATION IS PtRMTTtO 
ELSE JUST GET KtY GROtiP 



PAGE le 



SO«TTEST/T>rT 



DATAPOINT CONFIDENTIAL INDORSATION - SEE PACE 1 
SORT OPTIONS COMBINATIONS GENERATION PROGRAM 



199, 










2dt0, 


, «!(6443 


3MI 






2^\, 


, E^6444 


044 


006 




2^2, 


, tijt6446 


150 


112 


fcl5 


2«)3. 


, «!)6451 


074 


002 




2i?4, 


, Ki6453 


150 


ltd4 


t*l5 


2e5, 


, fci6456 


320 






206. 


»6457 


006 


114 




2187, 


<d6A6l 


370 






208. 


4^6402 


106 


011 


002 


209. 


»«i465 


302 






2ie, 


VI6466 


074 


006 




211. 


V56470 


110 


112 


ei5 


212. 


06473 


026 


110 




219. 


i»6475 


372 






214. 


06476 


106 


011 


002 


215. 


06501 


104 


112 


015 


216. 










217, 


065B4 


026 


124 




2ie. 


06506 


372 






219. 


«)6507 


106 


011 


002 


22(9. 










221. 


06512 


301 






222. 


06513 


044 


010 




223, 


, *-«)5l5 


150 


166 


irl5 ■ - 


224, 


06520 


901 






225. 


, ^6521 


04 4 


020 




226, 


, 06523 


026 


120 




227, 


, 06525 


150 


132 


015 


228, 


, 06530 


026 


129 




229, 


, 06532 


372 






230, 


, 06533 


106 


011 


002 


231, 


, 06536 


006 


065 




232, 


, PI6540 


370 






233, 


. 06541 


106 


011 


002 


234, 


. 06544 


301 






235, 


, 06545 


044 


040 




236 


, 06547 


006 


075 




237 


, 06551 


150' 


156 


015 


238 


, 06554 


006 


043 




239 


, ^6556 


370 






24^ 


, P6557 


106 


011 


002 


241 


, ^6562 


372 






242 


, «3fi563 


1(^6 


011 


002 


243 










2«« 


\ ?»6566 


3S3l 






245 


, ab567 


044 


100 




246 


, ^6571 


026 


0^6 




247 


, C6573 


335 






2«8 


, 06574 


346 






249 


, e>6575 


a66 


263 


n&e td2(d 


25<d 


, W166K51 


150 


2H^ 


fc^lS 


251 


, (/■.«>6«54 


1^66 


271 


IA5B 020 


252 


, i^'^OlkS 


li^e 


143 


0^2 



GET90S 


LAB 






ND 


3<l 




JTZ 


GETRG 




CP 


Kl 




JTZ 


SETTaG 




UCA 






LA 


'L' 




LM* 






CALL 


INCML* 




LAC 






CP 


3«l 




JFZ 


6ETKG 




LC 


•W 




LMC 






CALL 


iNCHLt 




JMP 


GETKG 


SETTAG 


LC 
L«C 


»T' 


dk 


CALL 


INCHLi 


6ETK6 


LAB 






NO 


1<3 




JTZ 


GETFB 




LAB 






NO 


1<4 




LC 


ipi 




JTZ 


SETPS 




LC 


»S' 


SETP5 


LHC 






CALL 


INCMLf 




LA 


'5» 




LMA 






CALL 


INCHLS 




LAB 






ND 


1<5 




LA 


•■• 




JTZ 


SETEI 




LA 


tmr' 


SETEI 


LMA 






CALL 


INCHL* 




LMC 






CALL 


INCHL* 


GETFB 


LA« 






NO 


l«6 




LC 


6 




LOH 






LEL 






HL 


KfcYFwD 




JTZ 


SETKEY 




HL 


KEYBxD 


SETKfcV 


CALL 


BLKTF»< 



GET SPECIAL OUTPUT SPfcClF ICaTION i 
NU SPECIAL OUTPUT 

TAG FILE OUTPUT 

SET THE LIMITATION 5T«I^G SPECIFICATION 

SEE IF HAROCOPY OUTPUT 

NO 

SET THE MAROCOPV OUTPUT 



SET THE TAG FILE OUTPUT 



SEE IF KEY GROUP SPECIFIED 

NO 

GET PRIMARY/SECONDARY 



PRIMARY 
SECONDARY 



PUT RECORD EVALUATION POSITION 



GET EQUIVALENCE/INEUUIVAUENCE 



EQUIVALENCE 
INEQUIVALENCE 



PUT HEADER KEY CHARACTEK 



GET KEY FORk^ARO/BACKWARO 



FURnARU 
BACKWARD 



HAGt n 



SCRTTEST/TXT 



DATAP0IN7 CONFIOeNTlAC InFOS^^ATION ^ SEE PAGg I 

SOHT OPTIONS COMBINATIONS GENERATION PROGRAM 



253. 












• 








254, 












• 


QISHLAY THE 


SDWT C 


255, 












• 








2S6. 


£^6613 


^66 


«60 


056 


025 






HL 


H19 


25;, 


06617 


\Vjb 


162 


V02 








CALL 


05PLT* 


256. 


i^6ft22 


k?66 


000 


gS6 


003 






HL 


HCWl 


259. 


»6626 


106 


162 


002 








CALL 


USPLY* 


26feJ, 












* 








261. 












• 


IF Th 


e»E IS 


TO SE 


262, 












• 








263. 


<*663l 


066 


144 


096 


014 307 






MLA 


*PRMFLG 


264, 


06636 


260 












ORA 




265, 


k^6637 


160 


270 


016 








JT8 


nXTPRm 


266. 


(A6642 


044 


004 










NO 


1<2 


267, 


06644 


150 


270 


016 








JTZ 


NXTPRM 


26B. 


06647 


066 


US 


096 


0)4 307 






MLA 


•LIMFLC 


269. 


(i6694 


044 


003 






GETLIH 


NU 


3 


27?, 


26656 


190 


304 


019 








JTZ 


N}^8f»<0 


27U 


06661 


074 


001 










CP 


I 


272, 


(96663 


190 


315 


ej9 








JTZ 


NHSBMO 


273, 


V46666 


074 


I*t02 










CP 


2 


274, 


H6670 


150 


326 


015 








JTZ 


POINTR 


275. 


(36673 


026 


013 










LC 


11 


276. 


M6675 


066 


312 


096 


020 






HL 


ASCIIS 


277, 


P'67Bl 


104 


334 


M19 








J«P 


SETLIH 


278, 












• 








279, 


^6704 


026 


005 






NHBF)»D 


LC 


5 


28^. 


«i67id6 


066 


277 


0S6 


920 






HL 


FwONMe 


281. 


4)6712 


104 


334 


015 








JHP 


SETLI>' 


282, 












• 








283. 


^6715 


026 


0B5 






N^tite^u 


LC 


5 


284. 


^6717 


066 


3U4 


fc?66 


^20 






HL 


BwoNMe 


289. 


i^67?J 


lk<4 


334 


015 








JMP 


SETLIH 


283. 












• 








287, 


\ 06726 


026 


001 






POlNTR 


LC 


I 


288. 


, i«673^ 


v^66 


311 


<Dtft 


JI20 






HL 


ASTEHX 


289. 












• 








290, 


\ 06734 


»)46 


160 


036 


i3l4 


SETLIM 


oe 


L1M5T« 


291. 


, H674(« 


lf^6 


143 


i'^'.2 








CALL 


blktfr 


292, 












* 








293 


, i.''07<i3 


.d&6 


145 


V.56 


<dl4 307 






MLA 


♦LI'^FLG 


294 


. ^675^5 


i\^ 












LBA 




2«i'& 


, ^6751 


353 












LHp 




29*5 


^6752 


364 












LLfc 




297 


. /675;? 


t^44 


($14 










xD 


3<2 


2«f< 


, 1^6755 


I5fei 


\Vib 


Vj\t 








JTZ 


e^uLi^' 


29^ 


, ^D76l' 


A2f> 


057 










LC 


'/ • 


i^V: 


, /.67b2 


372 












LMC 




l^l 


. ,ie)7«j3 


1^6 


*)U 


v.'^2 








CALL 


INCHL* 


vV? 


, /.b766 


it'l 












LAB 




3^3 


.1 ft 7 b 7 


v344 


(^14 










NO 


^<i 


3«54 


• fc 7 / I 


^7 A 


we 4 










CP 


\<l 


3^5 


■/i t7 7 .1 


15t* 


VI 51 


vjve 








JTZ 


St-TMOi' 


^'fh 


, ..^677^ 


*^2^ 


'.'6 5 










LC 


'5« 



CARRIAGE RETURN, LINE FEEO, LINE FEED 



SEE IF THERE IS A LIMITATION STklNG 

N0» NOT FOR INDEXED FILES 

NO 

GIT THE LIMITATION STRING FLAGS 

SEE MHICH OPTION TO USE 

DO POSITIONS FORWARD 

DO POSITIONS BACKWARD 

DO ASCII POINTER 
00 ASCII STRING 
'RECORD-* » 

11«*20 



20*11 



(itT Cjnl/ITIUNAL FLAbS 



NU CONOniCNb 



StE IF L'SJKU CUf^RtNl MtADtw 



ust MtAoew 

USE RECORD tVALUATIuN PUSlTiON 



PACE 12 



SORTTCST/TXT 



DATAPOINT CONFinE*<TlAL InFUR^ATION - SEE PAGE I 
SOWT OPTIONS CO'^SINATIONS GENERATION PROGKAN 



3«7 


, 070k»it 


372 










LMC 




3k)B 


, 07«0l 


106 


011 


0fei2 






CALL 


INCHLi 


3«*9 


, 070H4 


901 










LAB 




311? 


, 07WW5 


044 


004 








NO 


1<2 


3U 


, 07007 


026 


075 








LC 


»»• 


312 


, k«70n 


190 


016 


016 






JT2 


SETET 


313. 


, 07014 


026 


043 








LC 


i««ii 


314, 


, 07016 


972 








SETET 


LHC 




31S, 


, »)7017 


106 


011 


002 






CALL 


INCHLS 


316, 


, 07022 


070 










PUSH 




317, 


,. 07029 


066 


144 


056 


014 907 




1LA 


•PP«FLG 


318, 


, 07090 


060 










POP 




319, 


. 07091 


044 


020 








NO 


1*4 


920. 


. 07099 


026 


120 








LC 


ipi 


921. 


, 07099 


190 


042 


016 






JTZ 


SCTREC 


922. 


, 07040 


026 


129 








LC 


•8' 


929, 


, 07042 


972 








SETRtC 


LHC 




924, 


, 07049 


106 


011 


002 






CALL 


INCHLS 


925. 


, 07046 


104 


106 


016 






JHP 


CNOLXH 


926. 












t 






927. 


[ 07091 


070 








SETMOR 


PUSH 




92S. 


07092 


066 


144 


096 


014 907 




MLA 


•PRMPLS 


929, 


07097 


060 










POP 




990, 


07060 


044 


010 








NO 


i<3 


331, 


07(062 


110 


100 


016 






JF2 


PUTHiJK 


992, 


07069 


066 


145 


056 


014 907 




MLA 


*LI«PLS 


393, 


07072 


204 


001 








AO 


1 


394, 


, 07074 


970 










LMA 




395, 


07079 


104 


254 


« 19 






JMP 


6ETLI« 


996, 












■ 






997, 


07100 


026 


120 






PUTHDR 


LC 


ipi 


999, 


07102 


972 










LMC 




999. 


, 07109 


106 


Bll 


002 






CALL 


JNCMLS 


940, 












• 






941, 


07106 


026 


012 






ENOLlh 


LC 


10 


942. 


, 07110 


395 










LOH 




949, 


, 07111 


346 










LEL 




344, 


» 07112 


066 


926 


096 


020 




HL 


LI«CND 


345, 


, 07116 


106 


149 


002 






CALL 


8LKTFR 


346, 












• 






347, 


', fe)7l2l 


046 


160 


036 


014 




OE 


LIMSTR 


348, 


, t!)7l29 


066 


159 


056 


014 973 




HSO 


•PTABLE*1 


349, 


, 07192 


066 


152 


974 






rtSE 


PTABLE 



GET EVALUATION TYPE 



EQUIVALENCE 
INEQUIVALENCE 



GET THE RECORD EVALUATION CHARACTER 



PRIMARY 



HEADER SPECIFICATION ONLY VALID IF 
SORTING ON PNIMAHYS OR SECONDARIES 



ELSE JUST INCREMENT LIMITATION STRING FLAGS 



SET USE HEADER RECORD 



,' ',1-60CLEOR) 



PUT POINTER TO LIMITATION STRING IN PTASLt 
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S0HTU6T/TXT 



OATAPOXNT CONFIOENTIAU InFOKmaTION - SEE PAGE 1 
SORT UPTIONS COMeiNATlONS GfeNfcRATIOlvi PRQSHAm 



3t50 












* 




,551 












, DISPLAY THf 


: LIHITATI 


362 












• 




353 


, t^7l35 


\d4b 


013 


e36 


000 


oe 


11 


3S4 


, /.7141 


^td 


16K 


!?56 


014 


HL 


LIHSTP 


355 


, ^7145 


18b 


162 


i^H2 




CALL 


Q5PLY* 


35© 












f 




357, 


', 07150 


066 


144 


056 


014 307 


nik 


♦PRMFL6 


358, 


, 0715II 


044 


006 






nD 


3*1 


359, 


, 07197 


074 


006 






CP 


3*1 


360. 


, 07161 


110 


251 


016 




JFZ 


NXTLIM 


v)ei, 


07164 


046 


211 


036 


014 


OE 


MC0I#*6 


se2, 


07170 


066 


041 


R96 


003 


HU 


PR HOPS 


363. 


07174 


106 


332 


016 




CALL 


XF8EO0 


364. 


07177 


026 


012 






LC 


10 


969, 


07291 


066 


340 


096 


020 


ML 


SPACES 


366, 


07209 


106 


149 


002 




CALL 


SLKTFR 


367, 


07210 


066 


160 


056 


014 


HL 


LIMSTP 


366. 


07214 


106 


332 


016 




CALL 


XFRE08 


369. 


07217 


393 








L«& 




370. 


0722k» 


364 








LLC 




371, 


07221 


370 








L'^A 




372, 


^7222 


046 


211 


^'36 


014 


oe 


mEOJnG 


373, 


07226 


066 


199 


096 


014 373 


M80 


•PTABLe*3 


574, 


07293 


066 


194 


374 




H8C 


PTABLE*2 


375, 


07236 


046 


013 


036 


000 


oe 


11 


S76, 


07242 


066 


211 


096 


014 


ML 


HtOlMG 


577, 


07246 


106 


162 


002 




CALL 


OSPLt* 


376, 












♦ 




379. 












, NOW STRINGS 


APE ALL 


380, 












• 




381, 


(^7251 


066 


145 


4^56 


014 3<J7 


NXTLIM ML* 


♦LI«FlG 


382. 


07256 


004 


01«1 






AO 


1 


3e», 


V«7260 


570 








LMA 




384. 


07251 


074 


i920 






CP 


020 


385. 


w7?63 


lie 


27^^ 


^14 




JPZ 


S3TLNK 


386, 


n7Z&ft 


220 








SUA 




387, 


07267 


370 








LMA 




3B8, 












• 




389, 


i?*727i« 


vJ66 


144 


P66 


1^14 3V^7 


UXTPHH f*lh 


*PkhFL6 


39^. 


^-7275 


«Jkl4 


V^l^.l 






AU 


I 


391, 


, V\7277 


37(? 








L^A 




392 


, i«73wi'^ 


1^2 


32? 


P16 




CTS 


INXPRM 


3^3 


, »7ifii 


1^44 


W7/ 






NO 


^7^ 


394 


, (d7i<fit 


3m7 








LAM 




395 


, ffl73l^C3 


15P 


2/i? 


^14 




JTZ 


i>kTL'>''^ 


39t) 


, ^^73 11 


^44 


ei* 






NO 


■^\^ 


397 


. ^1 7 3 1 .5 


15.^ 


27^4 


fife 




JTZ 


NXjPk^ 


398 


, VI 7 3 1 6 


3lr->7 








I.AM 




399 


, ^173 17 


1 v'^ 


27VI 


014 




JMP 


bWTLNK 


A^\d 












* 




4<?l 


, (r732«i 


Vi4 4 


ftM 






JNXPWM NO 


l«2 


4k)2 


. H732^ 


3«7 








L*^ 




4^3 


, ^7325 


053 








»TZ 





SEE IF HARDCOPY OUTPUT 



NO 

CO»*STRUCT THE MAROCOPY HEADlNg 



PUT POINTER TO MEAOING STRING IN PTABlE 
DISPLAY The HAROCOPY MEAOING 

IMPUTE TmE next FLAGSI 
INCREMENT TmE LIMITATION STKInG FLAGS 



CATCH ALL LIMITATION UPTJCWS GENERATED 
LINK TO THE 30RT 
RESET LIMITATION FLAGS 



iNCHEHfNT The. PAWAMfcTtS STKX'^ib f-LAGS 

SPECIAL CHECKING IF GENERATING IMjEX PAKAHtft^ 
CATCH ND OPERATION CASES 

LINK TO The SORT 
gTH£H*»lS£ IF NUT USl^ib P/S 
SKIP THE PFfcRATION 

LINK TO THE SORT 

SMP GENERATION FOR ANV lI'-^ITaTIOn SThInG 

FINISH CHECKING IF NO LIMITATION STf^ING 
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S0RTTE8T/TXT 


404, 


PI7326 


060 






4tf5. 


»7327 


104 


270 


f^l6 


4P6, 










4^7, 


5^7332 


307 






4tfd, 


07333 


074 


019 




4if9. 


W7335 


053 






4lid. 


07336 


317 






4U. 


ii7337 


106 


391 


016 


^12. 


07342 


371 






413. 


07343 


106 


991 


016 


4t4, 


P7346 


104 


332 


016 


415. 










410. 


07351 


986 






417, 


87352 


004 


001 




416, 


07994 


964 






419. 


07359 


940 






420. 


07396 


909 






421. 


07357 


014 


000 




422. 


07361 


999 






423. 


07962 


990 






424. 


07369 


007 






425. 










426. 


07964 


066 


146 


096 014 907 


427. 


07971 


§04 


010 




42a. 


07973 


970 






429. 


07974 


220 






45k;. 


07379 


066 


191 


£56 014 370 



OATAPOINT CONFIDENTIAL INPORHATION • SEE PAGE 1 
SORT OPTIONS COMBINATIONS GENERATION PROGRAM 

ELSE SKIP 





POP 






JHP 


NXTPRM 


« 






XF«EOS 


LAM 






CP 


019 




KT2 






L8M 






CALL 


incsnp 




LM8 






CALL 


InCSkP 




JMP 


XFRE08 


• 






INCShF 


LAL 






AD 


1 




LLE 






LEA 






LAri 






AC 







LHO 






LOA 






RET 




NXTFIL 


MLA 


•FNTPTR 




AD 


6 




LMA 






SUA 






MSA 


*CIFL6 



HOVE A STRING UNTIL 019 E«.CQUNTeKEO 



INCREMENT THE FILE NAME TA6LE POINTER 



RESET THE FIR5T»TIME INDEX SwITCH 
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SQKTTfcST/TXT 



DATAPOINT CONFIOCNTIAL INFORMATION • SEE PAGE i 
SORT OPTIONS C0*^INAT10N5 GENERATION PROGHAI^ 



dvJl, 












432. 












434, 












434. 


f7 402 


;3t>6 


146 


056 


014 307 


435, 


k^ 7 4 e. 7 


idi^4 


212 






436. 


^^74 1 i 


36«} 








437. 


k»74l2 


006 


020 






438. 


07414 


a 14 


000 






439. 


k^74i6 


350 








448. 


PI7417 


307 








441. 


i^742f« 


260 








442, 


07421 


lb«i 


200 


020 




443. 


^^7424 


026 


010 






444, 


ii742e 


()46 


250 


036 


020 


445. 


»7432 


iei6 


143 


002 




446, 


^7439 


016 


020 






447, 


(57437 


026 


000 






448, 


^7441 


<»46 


250 


036 


020 


449. 


147449 


106 


066 


002 




450. 


0749B 


016 


040 






491, 


a7492 


026 


001 






452, 


»7494 


94f' 


000 


036 


000 


453, 


0746fcJ 


lk»6 


066 


002 




494. 


«'7463 


046 


307 


C36 


024 


495, 


«)7467 


106 


243 


017 




496, 


«I7472 


066 


233 


056 


^24 


457, 


1(^7476 


106 


162 


C02 




458, 












499, 


079i)l 


016 


020 






4 60, 


^79e)3 


106 


113 


002 




461, 


v^75fe!6 


026 


020 






462. 


075l« 


046 


224 


36 


003 


463, 


37514 


066 


164 


056 


003 


464, 


0752» 


106 


143 


002 




465. 


P'75?3 


026 


020 






46b. 


^7 525 


046 


164 


036 


003 


467, 


'^7531 


066 


2V.A 


6-56 


003 


468. 


P7535 


106 


143 


002 




469. 


vi754i^ 


016 


020 






a7\f 


t?7542 


106 


116 


v;02 




471, 


, H7545 


026 


020 






472. 


, «7547 


046 


204 


036 


003 


473< 


, ^•7593 


066 


164 


trst 


003 


474 


, f7557 


106 


143 


i>-^2 




475 


, k57b62 


326 


<^2i'- 






476 


ti7 5b4 


046 


164 


^■36 


003 


477 


, ^7i)7V 


Wfeh 


P24 


IV66 


0H3 


478 


. H7674 


1/6 


143 


002 




479 


. 87977 


016 


020 






4SW 


, i',76t!l 


lt?6 


121 


0V2 




481 


. 1-76^; 4 


260 








4a2 


, / 7 S t- 5 


U0 


1^*1 


tM7 




483 


, 7bli^ 


i^liS 


i?2ii 






AfM 


. y'7t\2 


li?6 


/77 


i-V2 





COPY THE FILE nAmEU IN 



CPYFIL 



CPYLUP 



^LA 


*FNTPTR 


AD 


FNTABL 


LLA 




UA 


FNTAaL>8 


AC 





LHA 




LAM 




ORA 




JTS 


EN0T8T 


LC 


a 


OE 


NAME XT 


CALL 


blktfr 


LB 


LFl 


LC 





OE 


NAHfXT 


CALL 


yPEN» 


LB 


LF2 


LC 


1 


OE 





CALL 


OPEN* 


D£ 


H19A 


CALL 


FNMOVE 


HL 


rti9 


CALL 


DSPLY* 


LB 


LFl 


CALL 


KEAD» 


LC 


16 


OE 


LFT+LF3 


HL 


LFT*LF1 


CALL 


QLKffR 


LC 


IC 


DE 


LFT+LFl 


HL 


LFT+LF2 


CALL 


aLKTFR 


LB 


LFl 


CAUL 


^RlTt» 


LC 


16 


OE 


LFT+Lf2 


HL 


LFT+LFl 


CALL 


bL«>TFR 


LC 


16 


DE 


LFT*LF1 


HI 


LFT4LF3 


CALL 


blhtfr 


LB 


LFl 


CALL 


GETS 


ORA 




JFZ 


CPYLJP 


LB 


LFl 


CALL 


CLOSE* 



THE FILENA'^E TABLE TO iNF ILE/TX T I OR 1 , 
INDEX INTO THE FILE NAME TAdLt 



CATCH END OF FILENAME TASlE ANO EwQ 0¥ T£i>T 



MOVE FILE MAME TO NAMEXT 



OPEN THE NAHEO FILE ON ORIVE 



OPFN THE IWPUT FILE ON DRIVE I 

JuST U8E THE PHYSICAL FILE NUMBER 
SVSTEM3/SY8 MUST BE PATCHED 
TELL OPERATOR NHAT'5 GOING On 

"SEQUENTIAL TEST FILE GENERATION U8IN& « 
"FILENAME/TXT," 

READ A SOURCE FILE RECORD 

SAVE UFI TABLE ENTRY 



MOVfe lF2 E^'T«Y to LFl ENTRV 

WRITE THE Input file RECORD 
S*VE t^2 TABLE ENTRY 

(RESTORE LFl TABLE EnTkY 

catch source eno-of-file 



LOOP IF NOT TH£rtt 

CLOSE The source file 



PAG£ 16 



SOWTTEST/TXT 



DATAPOINT CONFIDEMTIAW iNfOHMATION • SEE PA8E I 
SORT OPTIONS COMBINATIONS SENERATION PRO0RAM 



485. 


07615 


016 


040 








LB 


LF2 


486. 


B7617 


lfc6 


077 


lit' 2 






CALL 


CLOSED 


487. 


07622 


^16 


377 








LB 


-1 


488. 


i57624 


^66 


229 


096 


•4«)3 371 




MSB 


•LFT+LF3*! 


489. 


07631 


066 


012 


696 


«429 




HL 


«17 


400. 


07635 


106 


162 


002 






CALL 


DSPLYS 


491. 


07640 


104 


339 


014 






JMP 


GETAU 


4»2. 












* 






49d. 


07643 


066 


293 


056 


020 


FNMOVE 


HL 


nAhEXT 


494, 


07647 


3»»7 








FNMQVl 


LAH 




495. 


07690 


874 


048 








CP 


1 1 


496, 


07692 


198 


273 


817 






JTZ 


FNH0V2 


497. 


07699 


317 










L8M 




498, 


07696 


106 


391 


016 






CALL 


INCS»»P 


499. 


07661 


371 










LM8 




sue. 


07662 


106 


391 


816 






CALL 


INCSXP 


501. 


07669 


386 










LAL 




902. 


k»7666 


074 


260 








CP 


NAMEXT#8 


9^3, 


07670 


110 


247 


017 






JFI 


FNMOVl 


984. 












t 






909, 


07673 


926 


886 






FNM0V2 


LC 


6 


906. 


07679 


866 


392 


896 


828 




ML 


EXTTXT 


907, 


07701 


104 


143 


882 






JHP 


BLKTFR 



CLOSE THE "INPUT" FILE 

nAKE lF3 LOOK CLOSED TOO 

"DONE," 

KE«ENTER FLAG GENERATOR 

MOVE CHARACTERS UNTIL BLANK OR EIGHT CHaRaCTE-^S 



MOVE »/TXT.'#8l9 



PA&t 17 



50RT1E5T/TXT 



!5t4 6. 












♦ COPY 


THE NA^tEO FILE TO 7 


H 


5^9, 












t 








5ie. 


Z77\HA 


066 


146 


J156 


^14 307 


CVTINX 


«LA 


♦FNTPTR 




511. 


*?7\\ 


004 


212 








AO 


FNTABL 




512. 


c' 7 7 I 3 


360 










LLA 






513. 


^7714 


006 


020 








LA 


FfJTABL>8 




5t4. 


?7716 


014 


000 








AC 


V3 




515, 


*!7720 


350 










LMA 






516, 


?772l 


026 


010 








uc 


d 




517. 


v^7723 


046 


290 


036 


020 




DE 


NAMEXT 




518. 


i<f7727 


106 


143 


002 






CALL 


ttLKTFH 




516, 


07 7 W 


016 


020 








LB 


LFl 




520. 


87734 


026 


000 








LC 







521. 


07736 


046 


290 


036 


020 




OE 


NAMEXT 




522. 


e77«2 


106 


096 


002 






CALL 


OPEN* 




529, 


0774S 


016 


040 








LS 


LF2 




924. 


07747 


026 


001 








LC 


1 




529. 


07791 


046 


000 


036 


000 




OE 







526. 


07799 


106 


066 


002 






CALL 


OPEN* 




527. 


^776t? 


046 


374 


036 


024 




OE 


M16A 




928. 


M7764 


106 


243 


017 






CALL 


FN MOVE 




929. 


07767 


066 


329 


096 


024 




ML 


H16 




930. 


?7773 


106 


162 


002 






CALL 


DSPLV» 




931. 












• 








932. 


07776 


016 


020 






&£TRLC 


LB 


LFl 




933. 


10000 


106 


il3 


002 






CALL 


READ* 




534, 


10003 


016 


020 






GETBYT 


LB 


LFl 




935, 


10005 


106 


121 


002 






CALL 


GET* 




936. 


10010 


260 










OR A 






537. 


1 00 1 1 


150 


123 


P2P 






JTZ 


8RCE0F 




938. 


10014 


074 


015 








CP 


019 




939. 


t0«sl6 


150 


055 


^20 






JTZ 


PUTREC 




5dg, 


10021 


074 


0^3 








CP 


100.5 




9*1. 


10023 


190 


376 


017 






JTZ 


GETREC 




94^, 


10026 


074 


WU 








CP 


011 




543, 


1003i«5 


152 


0*^3 


«£0 






CTZ 


PUTSPC 




544. 


lt-.4533 


i?lb 


v;4i^ 








LB 


LF2 




545. 


10035 


lk!6 


127 


V02 






CALL 


PUT* 




545. 


lv*t»4« 


H'-4 


<iv:s 


ViZ\t 






JMP 


GETBYT 




•^47, 












» 




- 




5*8, 


l(^k34j 


1416 


P4f. 






PUTSPC 


LH 


Lfii 




549. 


10045 


lk)6 


127 


fe)iJ2 






CALL 


PUT* 




I>5ki, 


I ^k^SJ' 


^16 


fe)2il 








LB 


LFl 




551, 


IV) 1^52 


l?4 


121 


y)k;"2 






JMP 


UtT* 




552, 












f 








563, 


iv^55 


?.\b 


ViA^ 






PuTRtC 


L« 


L^2 




554. 


li5^57 


i«?e 


\i7 


<^<di 






CALL 


PtiT» 




555. 


l*?'-^^? 


k.'- vi 6 


yv?3 








LA 


3 




556, 


10Vb4 


l/b 


127 


^Vi? 






CALL 


PUT* 




557. 


X'l^^bJ 


22^ 








PAUKtC 


SUA 






55b, 


lfci?7i' 


\^f^ 


127 


fc-/2 






CALL 


PUT4 




^59, 


1 -^ ^ 7 ^ 


1/.1 


>-i6 7 


t*2f 






JFC 


PAORfcC 




5ftit^, 


1 to^7^ 


lv'6 


U^ 


/t^2 






CALL 


*PITE» 




^^\ , 


\^'\c\ 


wib6 


2-7 


t-bfr 


■M'^Z iv7 




ML A 


*LFT+LF2*LRN* 


1 



UATAPOINT CONFIDENTIAL INFORMATION • SEE PAGE I 
SORT OPTIONS COMBINATIONS GENtt<ATION PROGRAM 

iNOfcxED INPUT FILES 

INDEX INTO FILE NAMfc TABLfe 



MOVE FILE NAME TO NAMExT 

OPEN THE NAMED FILE 

BY NAME 

OPEN THE "INPUT" FILE 

BY PHYSICAL FILE NUMBER 

TELL OPERATOR WHAT'S GOING ON 

"INDFX TEST FILE GENERATION USING FILENAME/TXT," 

READ A SOURCE RECORD 

GET A LOGICAL SOURCE RECORD 

CATCH END OF FILE 

CATCH LEOR 

CATCH PEOR 

CATOH SPACE COMPRESSION 

PUT BYTt IF NUT tOH QR tU»- 

nu THE NEXT BYTE 



wWITt Thfc LttJK 
«KlTE Thfc PfcUW 
PAD TmE rest of Tnt KtCOKU TO ZfeWOS 



*W1TE THE WfcCOKU 

SEE IF THAT •"AS HtCUf<D 9695 



PAGE 16 




S0RTTE8T/TXT 






552, 


10106 


074 


049 






563, 


J0110 


110 


003 020 






564. 


10113 


066 


206 307 






569, 


10116 


074 


337 






566. 


10120 


110 


003 020 






567. 












568, 


10123 


016 


040 






969, 


10125 


026 


006 






570, 


10127 


220 








571, 


10130 


106 


127 002 






572, 


10133 


302 








573, 


10134 


024 


001 






574, 


10136 


320 








579, 


10137 


110 


127 020 






976, 


10142 


006 


003 






977, 


10144 


106 


127 002 






578, 


10147 


220 








979, 


10150 


106 


127 002 






960. 


10193 


100 


147 020 






981. 


10196 


106 


116 002 






982. 


10161 


106 


977 002 






963. 


10164 


016 


020 






984, 


10166 


106 


077 002 






989. 


10171 


006 


012 056 


029 




586. 


1U175 


lk;4 


162 0t;2 






587. 












588. 












589. 












590. 


10200 


066 


025 056 


025 




991. 


10204 


106 


162 002 






992, 


10207 


104 


151 002 






993, 












594, 












599, 












596, 












597, 












598, 


10212 


130 


104 111 


103 


124 


999, 


10222 


101 


104 HI 


103 


124 


600, 


10232 


101 


114 120 


110 


101 


601, 


10242 


377 








602, 












603, 












604, 












605, 


1^243 


011 


000 p;i3 


013 


023 


6u6, 


1H29M 


040 


040 040 


040 


040 


607. 


1^263 


061 


061 055 


362 


060 


608. 


10271 


062 


060 ^56 


«961 


061 


609, 


10277 


^bl 


061 055 


062 


060 


610. 


10304 


062 


060 055 


061 


061 


611. 


1^^311 


05^ 








612. 


lt^3l2 


047 


122 105 


1^33 


117 


613. 


llr4326 


054 


047 040 


047 


054 


614. 


I034f< 


040 


040 C^40 


04H 


040 


615, 


lk5352 


057 


124 130 


124 


056 



OATAPOINT CONflOENTUL iNFO^r'ATION * SEE PACE 1 
SORT OPTIONS C0HBINATXOH8 GENERATION PROGRAM 



NO 





CP 


9699»8 






JFZ 


GETBYT 






»«LA 


LFT*LF2*L« 


N 




CP 


9699 






JFZ 


GETBYT 




SRceoF 


LB 


LF2 






U 


6 




PUTEOF 


SUA 








CALL 


PUT* 






LAC 








SU 


1 






LCA 








JFZ 


PUTEOF 






LA 


3 






CALL 


PUTS 




PAOEOF 


SUA 








CALL 


PUTS 






JFC 


PADEOF 






CALL 


NRITCt 






CALL 


CLOSES 






LB 


LFl 






CALL 


CLOSES 






HL 


H17 




^ 


JMP 


QSPLT4 




, END OF THE 


SORT TEST: 




ENDT3T 


HL 


«18 






CALL 


OSPLYS 






JMP 


EXITS 





»»HITE EOF TO "INPUT" FILE 



CLOSE THE "INPUT" FILE 
CLOSE THE SOURCE FILE 

"DONE," 

AND EXIT 



"SOKT test COMPLETEU," 



FILE NAME TABLEt 

THESE ARE THE NAMES OF TmE BASIC SORT TEST FILES, ALL HAVE 

AN EXTENSION OF /TXT, 



FNTA8L 


DC 


'XDICT • 




OC 


'AOICT • 




DC 


'ALPHABET' 




OC 


•1 


, OTHER 


CONSTANTS USEu dV SQrtI 


Mil 


OC 


i^llf0r0l3f 11*^23 


NAMEXT 


OC 


' TxT' 


KEYFWD 


OC 


'll-20'i015 


KEYBwD 


OC 


'20-ll'»tfl5 


Fl*DNMB 


DC 


'11-20' 


BNDNMB 


DC 


'20*11' 


ASTERX 


OC 


' « « 


ASCIIS 


OC 


•»»'ReCORD^> «' '»3 


LIMENO 


OC 


',•• «',1-60',^15 


SPACES 


DC 


1 1 


EXTTXT 


OC 


•/TXT, ',3 



HACt IW 




SOWT 


EST, 


/TXT 




61b, 












617, 












618, 












619, 












620, 












621, 












622. 












623, 












624, 












625, ] 


096*9 


220 








626, 1 


0961 


066 


144 


056 


014 970 


627. 1 


0366 


066 


149 


370 




626. 1 


0371 


066 


146 


37? 




629. ] 


0374 


066 


151 


370 




6de. 1 


0977 


066 


149 


099 


009 907 


631. 1 


0404 


044 


003 






632. 1 


0406 


046 


001 


096 


029 


693. ] 


0412 


lie 


371 


022 




694, 1 


0419 


066 


144 


307 




639. 1 


0420 


066 


190 


IP96 


fl4 37f 


636. 












637, 1 


0425 


006 


170 






638. 1 


(?427 


040 








699, 1 


0490 


121 








640, 1 


0491 


006 


001 






641, 1 


0499 


191 








642. 1 


0494 


900 








643. 1 


0439 


101 








644, 1 


0436 


900 








649, 1 


0497 


012 








646. ] 


0440 


046 


049 


096 


^29 


647, 1 


0444 


100 


062 


021 




348, 1 


0447 


006 


002 






640, ] 


04^1 


191 








690, ] 


M492 


900 








651, 1 


0499 


101 








692, 1 


0494 


9kii^ 








693. ] 


0495 


012 








654, ] 


0496 


046 


P)75 


P36 


023 


655. ] 


0462 


050 








656, 1 


0469 


ie0 


971 


e22 




697* 












65«, 


0466 


016 


l?20 






^59, 


10470 


026 


ifi^& 






66?. 


10472 


1^46 


101 


096 


025 


6M. 


1^476 


106 


066 


t02 




e62. 


10901 


046 


127 


l?.36 


^2 3 


669. 


10505 


140 


371 


022 




664. 


10910 


066 


164 


R96 


00 3 3t!>7 


665, 


10515 


066 


147 


t56 


i»14 37n 


666, 


10522 


026 


00(^ 






667, 


10524 


046 


114 


?36 


025 


666, 


1059*^ 


106 


066 


ij02 




^6», 


1^^533 


046 


165 


i^Z6 


i?l23 



OATAPOINT CONFIDENTIAL InFOHmATION » SEE PAGt I 
SORT OPTIONS COflBlNATlONS GENfe«*TIQh, PROGHAf^ 



+ 

* • * 

* 



START 



Ulililttiit*** ************************* 

INITIALIZATION MOQULt 

THIS HODULE 13 EXECUTEO ONU*^ ONCEi AT SORT TEST INITIALIZATION, 
*1iliii*t*** ***************, ********** 

INITIALIZE the' PAKAMETER FLAGS 



INITIALIZE THE PILE NAME TABLE POINTER 
iNlTIALlZf THE iNOfXeO FILE GENERATION SWITCH 
CHECK THE SORTTEST/CMO DRIVE NUMBER 

■SO«TT£«T/CMD NOT FROH DRIVE «,* 

SET »0RTTE5T/CHD PHYSICAL FILE NUH8ER 

SEE IF DRIVES 1 AND 2 ARE THERE 



NOURVl 



SUA 




MS A 


♦PRMFLB 


MSA 


LIMFLG 


MSA 


FNTPTR 


MSA 


CIFLG 


MLA 


♦LFT*LF«*1 


ND 


3 


OE 


Mei 


JFl 


ERROR 


ML A 


LFT+LF0 


MSA 


♦TSTPfN 


LA 


0170 


PI 




EX 


ADR 


LA 


1 


EX 


COMl 


NOP 




IN 




NOP 




SRC 




DE 


M02 


JFC 


NODRVl 


LA 


2 


EX 


COMl 


KOP 




IN 




NOP 




SRC 




DE 


M03 


EI 




JFC 


ERHOR 


LB 


LFl 


LC 


k) 


ot 


SMTCHU 


CALL 


OPEN* 


OE 


M04 


JTC 


ERROR 


MLA 


*LFT*LFi 


mSA 


*S«TPfN 


LC 


^ 


i)E 


5HT0V1 


CALL 


OPEN* 


DE 


H09 



•DRIVE 1 NOT ON LINE," 



"OHIVE 2 MOT ON LlNt," 



CH£C»< FOR SORT L'TIUITY PILfeb 
ON bKIVE Ut<0 



"jjOHT/C^^D WOT Di«J DRlVt 0," 

SfeT SOHT/C^U PHYSICAL F iLt NUhStW 

"SU^T/Ovl NOT UN DRIVE M," 



PAGE 2tf 



S0RTTE8T/TXT 



DATAPDINT CONFIOENTlAL iNfORHATlON - 8EC PACE 1 
SORT OPTIONS COHBI^ATIOnS SENERATXON PROGRAM 



97?, 

671, 

672, 

673, 

674. 

675, 

676. 

^77, 

678, 

67&. 

660. 

681, 

662, 

689. 

684. 

685, 

686. 

687. 

688. 

689, 

690, 

691, 

692. 

693. 

694. 

695. 

696, 

697, 

698, 

699, 

79%, 

7t\, 

7«>2. 

7»3. 

7«l4, 

7«»9. 

7«»6. 

7^7 , 

708, 

7e9, 

71i*, 

711. 

7 12. 

713. 

714, 

719. 

716, 

717. 

718. 

7ie. 

72**. 
721. 
7 22, 
723, 



1«5937 140 371 022 



1«S42 
1«546 
lid551 
18593 
10597 
lfe»962 
10967 
10571 
10574 
10576 
18602 
106(99 
10606 

106U 
10619 
10620 
10622 
10626 
10691 
10630 
10640 
10643 
10649 
10691 
10694 
10699 



10660 
10661 
10669 
10664 
10666 
10670 
10671 
10672 
14^673 
10676 
10700 
10704 
10707 
1^^711 
10713 
10717 
lrt722 
M725 
10732 
lki734 
lk!735 



066 223 096 023 

106 162 002 

026 002 

^66 127 096 029 

106 197 002 

066 127 056 029 307 

074 131 

190 211 021 

074 116 

066 262 ?56 023 

190 971 022 

191 

104 142 021 



* 
GETitC« 



JTC ERWQR 

HL M06 
CALL USPLY* 
LC 2 
HL REPLV 
CALL KEYiNt 
MLA ♦REPLY 
CP 'Y« 

HAKSUR 

M07 

ERROR 

BEEP 

CETSCR 



'uRIVES 1 AND 2 SCRATCH T " 



JTZ 

CP 

HL 

JTZ 

EX 

JHP 



066 
106 
826 
966 

106 
066 
•74 

sse 

074 
946 
150 
151 
104 



220 

004 
960 
006 
814 

950 
307 
260 
160 
026 
046 
106 
016 
026 
046 
1W6 
140 
066 
004 
370 
046 



911 096 (129 

162 002 

002 

127 096 029 

197 002 

127 096 029 907 

131 

200 021 

116 

940 096 029 

971 022 

211 021 



212 

820 
008 



017 022 

010 

290 036 020 

149 fe!02 

020 

800 

250 036 020 

066 002 

347 021 

146 056 014 307 

k;i0 

376 (^36 023 



MAK3UR HL H08 

CALL D8PLYS 

LC 2 

HL REPLY 

CALL KEYINS 

MLA •REPLY 

CP 'Y» 

JTZ FNTCMK 

CP 'N' 

OE H09 

JTZ ERROR 

EX iiCEP 

JHP HAKSUR 



"END OF SORT TEST," 

TRY AGAIN 

"•♦• ARE YOU SURE 7 ♦♦• * 



IF 80 CHECK THE FILE **AM£ TABLE 
"I DIDN'T THINK SOi" 



, HAKE SURE ALL OF THE BASIC TEST FILES IN THE FlLt NAME TABLE ARE 

. ON DRIVE ZEROI 

t 

INDEX INTO THE ENTRY 



CATCH ENQ OF TASUt 
MOVE NAWE TO NAMtxT 
TRY TO nP£N THfc FILE 



JUMP IF NOT THERE 
BUMP THt POINTER 



FNTCHK SUA 




FNTCKL AO 


FNTA8L 


LLA 




LA 


FNTABL>8 


AC 





LHA 




LAH 




ORA 




JTS 


E^DFnT 


LC 


8 


UE 


NAMEXT 


CALL 


BLKTFR 


LB 


LFl 


LC 





OE 


NAMfcXT 


CALL 


JPEN» 


JTC 


NOFILE 


ML* 


•FnTPTR 


AO 


8 


LMA 




DE 


M10 



"TOO MANY FILES," 



UATAPOINT COwriOENTlAL INFO«^ATIaN • SEE PAttt 1 



PA&t 21 




SOi^TI 


rEbT/T)(T 


SORT 


PTION. 


S COMBjlNAT 


724, ] 


k?74l 


156) 


,571 1^22 




JTZ 


ERHOH 


725, 1 


«)74« 


i^A 


261 021 




JMP 


FNTC^L 


726, 








• 






727, 1 


k4747 


i/?26 


010 


NOFILE 


LC 


8 


728, 1 


€7bl 


.366 


2i>tA (^56 td20 




HU 


NA'^tXT 


72'i, 1 


*J755 


3*97 




MOFILI 


UAM 




73iS, J 


0796 


«7A 


040 




CP 


1 1 


73i* 1 


^76^ 


150 


379 <^'il 




JTZ 


N0FIL2 


732, 1 


0763 


106 


011 602 




CALL 


INCHLl 


733, I 


n76e 


302 






LAC 




734, I 


0767 


024 


001 




9U 


I 


739, 1 


0771 


320 






LCA 




736. I 


0772 


104 


355 021 




J HP 


NOFILl 


737. 








f 






738. 1 


0779 


026 


032 


N0FIL2 


LC 


M12*HllA 


739, I 


0777 


339 






LOH 




740. 1 


1000 


346 






LCL 




741. 1 


1001 


066 


030 096 024 




HL 


«11A 


742. 1 


1009 


106 


143 002 




CAUL 


BLKTFR 


743. 1 


leie 


046 


243 036 020 




DC 


MM 


744. I 


1014 


104 


371 022 




JMP 


E»ROf* 


749, 








• 






746. I 


1017 


224^' 




eNDFNT 


SUA 




747. I 


1020 


066 


146 056 014 370 




HSk 


*FnTPT« 


74S. 








* 






749. 1 


1029 


006 


001 




LA 


1 


75*5. 1 


1027 


066 


009 056 000 370 


KiLLtH 


HSA 


•OPtPON 


791, 1 


1034 


050 






EX 




792. 1 


1039 


006 


170 




LA 


^170 


793. I 


1037 


040 






01 




794. 1 


1040 


121 






EX 


ADR 


759, I 


1041 


300 






MOP 




796. 1 


104J? 


006 


011 




LA 


9 


797. 1 


1044 


131 






EX 


COrti 


798. 1 


i049 


£00 






NOP 




799. 1 


1046 


230 






X»A 




760, \ 


li^47 


137 






EX 


COM4 


761. 1 


1^5«« 


3t»0 






NOP 




762. 1 


1051 


0k56 


377 




LA 


-1 


763. \ 


l»»93 


127 






EX 


»(RIT6 


764, ) 


Ub4 


016 


312 




L& 


2^2 


769, 


11096 


050 




FRtCYW 


El 




7bb, 


11^57 


0k)6 


170 




LA 


/170 


757, 


lli461 


04^ 






01 




76». 


Ui^62 


121 






6X 


AOK 


769, 


I l/ifti 


3UIZ 






NOP 




?7tf. 


11264 


25^ 






XRA 




771, 


U<«f»9 


127 






EX 


"►•lit 


772. 


1 lv*66 


3^1 






LAB 




773. 


llv^6 7 


ii;24 


^k- 1 




3U 


I 


77A, 


11«^71 


31*8 






LBA 




779. 


n " 7 2 


11'^ 


vi56 ^"22 




JFZ 


FRECVL 


776, 


11^75 


^It 


^^4 




LB 


1^376-202 


77 7. 


11/7 7 


/ib-^ 




LUKkST 


tl 





^hECK next ENTRY 

SCAN THE NAMt: FOR A BLA^I* 

FOUND 



HOVt THf REST OF THE MESSAGE TO NAME 



"/TXT NOT ON DRIVE 0,'» 

RESET THE FILE NAME TABLE POINTER 

KILL ALL PILES ON UHIVtS 1 AND 2 
SELECT DISK CONTROLLER BUFFER ZERO 



S*T THE DISK SUFFfcR INTERNAL ADDRtSC 



BE SURE CVLINUEK ZERO IS SAVED 

INITIALIZE THE CVLlNUtH CUUnT 
E'^ASLE INTERRUPTS FUR LOUPIixG 



FwEfe TH£ CtLlNUEH 

DECREMENT THE CYLINDEW COU.mT 

LOOP If NOT TMfcHt 
LuCi^ OUT THE RhbT 



A6£ 22 




SORTTEST/TXT 


778, 


11100 


006 


170 


779. 


11102 


040 




780. 


11103 


121 




781. 


11104 


300 




782. 


11109 


006 


377 


783, 


11107 


127 




784, 


11110 


301 




786, 


11111 


024 


001 


786. 


11113 


310 




787. 


11114 


110 


077 022 


788. 


11117 


127 




789. 


11120 


090 




790. 








791, 


11121 


016 


000 


792. 


11123 


046 


000 036 000 


793, 


11127 


106 


099 002 


794. 


11132 


140 


301 022 


799. 








796. 


1U39 


006 


J70 


797, 


1U97 


040 




798. 


11140 


121 




799. 


11141 


300 




890. 


11142 


290 




801, 


11143 


137 




802. 


11144 


310 




803. 


11149 


090 




804, 


11146 


006 


170 


809, 


11190 


040 




806, 


11191 


121 




807, 


11192 


300 




808, 


11193 


006 


377 


809. 


11199 


127 




810, 


11196 


301 




811. 


11197 


004 


001 


812. 


11161 


310 




813. 


11162 


110 


149 022 


814, 


11165 


990 




819, 








816, 


11166 


016 


000 


817. 


m7p 


046 


001 036 000 


818, 


11174 


106 


099 002 


819. 


11177 


140 


301 022 


820. 


11202 


304 




821. 


11203 


004 


001 


822, 


11209 


340 




823. 


11206 


074 


030 


624, 


11210 


110 


174 M22 


825. 








826. 


11213 


066 


005 096 000 307 


827. 


1122i«^ 


064 


060 


828. 


11222 


066 


079 056 ^24 370 


829. 


11227 


066 


062 056 024 


830. 


11233 


106 


162 002 


831. 


11236 


066 


009 096 000 307 



OATAPUINT CONFIDENTIAL iNfUKHATION • SEE PAGE 1 
SORT OPTIONS COHBINaTIOnS &tNERATZON PROGRAM 



LA 


0170 


DI 




EX 


AON 


NOP 




LA 


•1 


ex 


WRITE 


LAB 




8U 


1 


LBA 




JP2 


LOKRST 


EX 


^•RITE 


El 




• 




L8 





DE 





CALL 


OMS 


JTC 


D8KERR 


• 

LA 


0170 


01 




EX 


AON 


NOP 




XRA 




EX 


COM4 


LBA 




CLRPAG EI 




LA 


»170 


01 




EX 


AOR 


NOP 




LA 


•1 


EX 


WRITE 


LAB 




AD 


1 


LBA 




JPZ 


CLRPAG 


EI 




LB 


>4 


DE 


1 


DIHt»RT CALL 


D«S 


JTC 


OSKERR 


LAE 




AO 


1 


LEA 




CP 


id30 


JFZ 


OIHWRT 


• 

HLA 


♦OOSPON 


OR 


»0» 


MSA 


♦ M12A 


HL 


^12 


CAUL 


OSPLYI 


MLA 


♦005PUN 



LOOP IF NOT THERE 
FINISH OFF •"ITH A ZERO 



CLEAR THE CLUSTER ALLOCATION^TABLE 

CATCH DISK ERROR 

NOM CLEAR THE OIRECTORY MASTER 

INITIALIZE THE BUFFER POINTER 
ENABLE INTERRUPTS FOR LOOPING 



BUMP THE BUFFER POINTER 

CLEAR THE OIRECTORY MASTER 

BUMP THE PAGE POlMTtK 

LOOP IF NOT THERE 

DISPLAY THE CLEAR ntSSAGEl 

"DRIVE N CLEARED," 



OATAPOINT CONFIOENTXAU INFORMATION • SEE PAGE I 



FAGk ?3 




SUf^T 


lEST/TXT 






SORT C 


PTION, 


3 CO MB IN 


d32. 


11243 


<;^4 


^?.l 










AD 


I 


833, 


11245 


ij74 


i^t<!3 










CP 


2*1 


834, 


11247 


n«$ 


027 


022 








JFZ 


KiLLEH 


839, 














* 






836, 














, CREATE Tm£ 


INPUT/T 


837, 














t 






838, 


tl292 


«16 


020 










IB 


LFl 


839, 


11294 


^26 


("ifll 










tc 


1 


«40, 


11296 


046 


066 


036 


025 






01 


INFILE 


841, 


11262 


106 


063 


002 








CALL 


PREPS 


842, 


11269 


026 


001 










LC 


I 


643, 


11267 


046 


340 


096 


049 






OC 


9696 


844, 


11273 


106 


109 


002 








CAUU 


PROTE* 


846, ] 


11276 


104 


002 


017 








J MP 


CP^Flt 


646. 














* 






847, ) 


1901 


066 


009 


096 


eee 


907 


OSKERR 


ML A 


•0D8P0N 


840, ] 


11306 


190 


327 


022 








JTZ 


06KPAR 


849. ] 


1311 


064 


060 










OR 


»if 


890, ] 


1913 


866 


129 


066 


024 


970 




MSA 


♦ M19A 


89J, \ 


1320 


049 


Jl« 


090 


084 






OE 


M19 


892. ] 


1324 


im* 


371 


022 








JMP 


ERROR 


893, 














t 






894, ] 


1327 


064 


060 








OSKPAR 


OR 


«0» 


699, ] 


1331 


066 


177 


096 


024 


370 




MSA 


♦ M14A 


896. ] 


1336 


304 












LAE 




897. i 


1337 


044 


003 










NO 


3 


898. ] 


1341 


064 


060 










OR 


•0» 


899, 1 


1343 


066 


230 


056 


024 


370 




MSA 


• Ml 48 


860. ] 


1390 


304 












LAE 




861, ] 


1391 


012 


012 


012 








SRN 


3 


862. ] 


1394 


4)44 


003 










MD 


3 


863, 1 


1396 


tl64 


fe?«(?» 










OR 


I4J« 


864. ] 


1362 


«)66 


227 


W96 


024 


370 




hSA 


*rti4B*l 


869. ] 


1369 


246 


144 


036 


024 






DE 


M 1 4 


866, 














• 






867, i 


1371 


35i 










tHROK 


LHO 




868, 


1372 


36< 












LLE 




869, 1 


1373 


lf*6 


162 


i*^'2 








CALL 


OSPLV* 


87?, 1 


11376 


1^4 


151 


V<6 2 








JMP 


EXIT* 



00 DRIVE T*0 IK NUT DONE 
UN 0«IVE II 
GENERATE TMt FILE 

SET The file size TO MAXIMUM 

COPY THE FIRST f^lLE TO INPUT f ILE 

GET THE DRIVE NUMBER 

CATCH PARITY ERROR 

PUT DRIVE NUMBER IN MESSAGE 

"ORIVE N wtNT OFF HWE," 

PUT DRIVE NUMBER IN MESSAGE 
PUT SECTOR ADDRESS IN MESSAGE 



POINT TO tRROP> MESSACst 



PAGE 24 



SORTTEST/TXT 



DATAPOINT CONFIDENTIAL INFOKHaTION m $tt P*Bt I 
SORT OPTIONS COMBINATIONS GENERATION PROGRAM 



B71 

B72, 

b73, 

874, 

875, 

676, 

877, 

678, 

879, 

880, 

881 

882, 

683, 

884, 

889, 

866, 

887, 

888, 

669, 

696, 

891 

892, 

693, 

694, 

895, 

896, 

897, 

898, 

899, 

999, 

981 

902, 

993, 

994, 

909, 

996, 

997, 

941)6, 

9id9, 

910. 

911 

912, 

913, 

914, 

915, 

916, 

917 

918, 

919, 

92^, 

921 

922, 



14fcl 
1406 
1443 
1450 
1479 
1502 
1527 
1534 
1969 
1972 
1623 
1630 
1662 
1667 
1711 
1716 
1746 
1793 
1776 
2093 
2890 
2099 
2062 
2^67 
2079 
2110 
2119 
2123 
2144 
2191 
2177 
2230 
2239 
2241 
2307 
2925 
2339 
2374 
2412 
2417 
2425 
2432 
2460 



011 
123 

eu 

104 

011 
104 

011 
123 

01V 

129 

011 

104 

011 
109 
011 

092 

011 
111 
011 

124 

011 
097 
011 

104 
116 
011 
104 
116 
011 
120 
116 
060 
011 
129 
106 
011 
111 
106 
011 
104 
011 
123 
011 



000 
117 

000 

122 
000 
122 
000 
117 

000 

117 



122 
000 
116 
000 
092 



040 
000 

117 
000 

124 

000 
122 
040 
000 
122 
040 
000 
101 
040 
096 
000 
109 
HI 
000 
116 
HI 
000 
117 
000 
117 

000 



019 
122 
019 
111 
019 
111 
019 
122 
019 
122 
019 
HI 
019 
104 
019 
052 
019 
104 
019 
117 
019 
190 
019 
HI 
109 
019 
HI 
127 
019 
122 
101 
019 
019 
121 
114 
019 
104 
114 
019 
116 
019 
122 
019 



013 
124 
019 
126 
019 
126 
019 
124 
013 
124 
019 
126 
019 
040 
019 
040 
019 
HI 
019 
040 
019 
124 
019 
126 
114 
019 
126 
109 
019 
HI 
124 

019 

129 
109 
019 

109 
105 
019 
105 
013 
124 
013 



029 
124 
029 
109 
029 
1«9 
029 
097 
029 
097 
029 
109 
029 
117 
029 
101 
029 
104 
029 
119 
029 
040 
029 
109 
109 
029 
109 
116 
829 
124 
040 

029 
109 
116 
029 
190 
116 
029 
090 
029 
040 
029 



2466 111 116 106 HI 114 



2501 
251A 
2527 

ii*36Sb 



129 
123 



117 

H7 



122 
122 



124 040 
124 040 



M01 

^02 

M09 

M04 

H05 

H06 

N07 

n08 

M09 

H10 

HllA 

«12 

N12A 
H19 

Mt9A 
M14 

M14A 
M14B 
H19 

H15A 
M16 

M16A 
M17 

M18 

H19 

INFILE 

8RTCH0 
SRTOVl 
REPLV 



DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 

DC 

DC 
DC 

5K 

END 



0H#^#v*13,lH029 

•80RTTE5T/CH0 NOT ON Df^IVt O,'f0ig 

^Hi0i019,H»029 

'DRIVE 1 NOT ON LlNE,'fei5 

0Hf0»019Hlf029 

'DRIVE 2 NOT ON WINE, ',019 

01H>)#^19,11,029 

•SORT/CIO NOT ON DRIVE 0,'»015 

011»0»0l9rlH029 

•SORT/OVl NOT ON DHlvE 0,',019 

^Hr0r019Hlf029 

'DKIVtS I AND 2 SCRATCH ? »,9 

01H0f019,lH029 

•END OF SORT TEST, ',019 

0Hf0r019,H»029 

I*** ARC YOU SURE ? *♦* •#9 

011*0#019»H,029 

>I OIDN«*T THINK 901', 015 

011f0»019Hl#029 

»T00 HANT TEST FILES,', 015 

0Hf0#019Hl»829 

•/TXT NOT ON DRIVE 0,',019 

0H»0f019, 11,029 

'DRIVE ' 

'N CLEARED, 1,9 

&}Hf0#0l9,H,029 

'DRIVE » 

'N NENT OFF LINE,*, 019 

011,0,019,11,029 

'PARITY ERROR ON DRIVE ♦ 

*N AT CYLINDER SECTOR 00' 

•0,*,019 

011,0,019,11,029,029 

'SEQUENTIAL TEST FILE GENERATION USING « 

»FILENAH£/TXT,',9 

011,0,019,11,029,029 

'INDEX TEST FILE GENERATION USING ' 

•FILENAME/TXT, ',9 

011,0,013, 11, t«2d 

•DONE, 1,015 

011,0,019,11,029 

'SORT TEST COHPL£TEO,',029,015 

t'l 1,0, 01 9, 11, 029, 015 

'INFILE TXT' 



'SORT 
•SORT 
2 

START 



CMO' 
OVl' 



PAGE. 25 



SOWTTEST/TXT 



OATAPOINT CONFIOENTIAL InFOH^'*TION • SEE PAGE I 
SORT OPTIONS COMBINATIONS GfcNERATION PROGRAM 



10312 


ASCIIS 


103U 


ASTERX 


i^lU^ 


atKTi^K 


i?0(!i34 


at^^ 


BlBt^e 


BOOTS 


0H35 


d9P» 


00(419 


euFAOR 


103«4 


8i«0NH8 


10000 


CASADS 


01102 


CHOP* 


0<$1S1 


CIFUG 


91677 


CLOSES 


Cl|?44 


CLWIS 


U145 


CLRPA6 


1^400 


CrxQAOS 


14507 


CHOINT 


1700*^ 


COVAOS 


ti7a^2 


CPYFIL 


^?5«!1 


CPYLUP 


.■» 1 k!" 3 J 


ts» 


\^?iifiib 


CSu 


^n^A 


CvTi~X 


K6^?." 


utaios 


01154 


OF.BUGI 


•^Iv^Jg 


otCML 


11174 


ulHnR^ 



276 


*612 




28B 


♦en 




• seiA 


292 


291 


5«7 


518 


714 


*96IA 






*9tA 






*92IA 






* 1021 A 






284 


*6ie 




*n4iA 






*43|A 






*134 


IBS 


187 


*42tA 


484 


486 


*22tA 






*803 


813 




♦115IA 






♦ 31IA 






♦ UftlA 






nAiA 


845 




*459 


4B2 




«19IA 






• 97 : A 






U6 


*510 




♦U21A 






*56l A 






*27IA 






♦ 61» 


824 





345 
742 



366 



445 



464 



468 



474 



478 



430 
982 



629 
584 



uATAPOIWT CONFIDENTIAL I»»FO»«ATION • ilt PACt I 
PAGE 26 SO«TTtST/TXT SORT (3PTI0NS COHBInaTIQnS GtNeR«TlDK PROGRAM 



V?li?«il? 


UOSA0* 


*i!3etA 








40005 


a05PU^ 


*8ijilA 


751? 


826 


831 


Via<d^4 


DUSHFK 


*79IA 








net^Ze 


nnSHTw 


*81IA 








(flP52 


UWi 


*13SA 








Udtfll 


OSKtH>» 


794 


619 


*647 




1132^ 


OSkPah 


846 


• 854 






01060 


OSKMAT 


• iStA 








05400 


OSPAOS 


♦IIBIA 








01162 


OSPI.V* 


• SBIA 
673 


297 

687 


299 

630 


399 
669 


V)\95S 


0*% 


*14IA 


793 


818 




11217 


t\ofN^ 


711 


• 746 






0/ leo 


tWULi*^ 


40C 


•iiii 


*0«»i 




l/?vH3 


f »jnT§T 


4 4? 


• 59^ 






11371 


ERROR 


633 


696 


663 


670 


01151 


EXIT* 


*3^tA 


592 


870 




10332 


EXTTX1 


506 


♦615 






07647 


Fm»*0V1 


*494 


503 






07673 


FN«0V2 


496 


•51(55 • 






W7643 


►"■^r^nvE 


4S5 


• 493 


528 




10212 


FNTAbL 


435 


447 


511 


913 


iaee« 


f^NfCHU 


ayi 


• 703 






10661 


FnTC»^1. 


*704 


725 






i(J6l46 


FMf^'TK 


«131 


426 


434 


510 


110S6 


►«tLYL 


#765 


775 






10277 


FwON***; 


260 


• 609 






k!1121 


i.tT» 


*4&tA 


48e 


535 


591 



847 



377 457 498 530 986 991 



682 696 724 744 892 *867 



.•996 704 706 



628 720 747 



OATAPOINT CONFIOENTIAU INFORMATION » SEE PAGE I 
PACE 27 SOKTTEST/T^tT SORT OPTIONS COMBINATIONS StNgRATlON PROGRAM 

06335 GETAD 

10«W3 GETbYT *334 546 563 566 

06362 GtTCI 

0656b SETFB 

06512 G£TKG 196 2tf2 211 215 *221 

86654 GETUIM 

01047 GETNCM 

91124 GETRS 

07776 6ETREC 

10542 GETSCR 

06449 GETSOS 

(*62U HEDING *142 361 378 376 

ai?U INCHU 

010U INCHL« *1^7 177 193 2(08 214 21» 23<9 233 240 242 

319 324 339 732 

37351 ImCSwP 411 413 «416 498 500 

12466 INFIUE 

«?!7382 i\XPRM 

v!l5572 KEYAO* 

10271 KEYBWO 

12263 K£YF«U 

M1157 KEYiNt #57tA 676 69(d 

llio27 MULE'' 

k3001iilfl l.nHAD* 

\/>^v>&^ LF/ weeiA 630 634 

Pi002e UFl *e7lA 446 459 469 466 469 473 476 479 463 

534 550 583 658 664 715 838 

u^0040 tF2 *8CtA 450 467 472 485 523 544 548 553 561 



*i7fc 


491 


*534 


546 


174 


♦179 


223 


• 244 


196 


202 


• 269 


335 


*12tA 




*49tA 




• 538 


541 


•672 


984 


181 


•200 


•142 


361 


• 261 A 




• 107 


177 


301 


906 


411 


419 


84i; 


•916 


J9£ 


• 401 


•lUIA 




251 


• 608 


249 


*f><f7 


*57t A 


676 


• 75kJ 


834 


« U5 7 J A 




• 861 A 


630 


♦ e7iA 


4 46 


519 


532 



DATAPOINT CONFIOeNTlAL InF0H«aT10N • 8E6 PA6t I 
PAGE 28 SORTTCST/TJiT SORT OPTIONS COHBINaTIOnS CfcNeRATlON PROfiRAM 







564 


seb 








ti)id«i0« 


UFi 


• 891* 


462 


47 7 


488 




M1944 


LFT 


*89J* 
561 


462 

5b4 


469 
630 


466 
634 


467 
664 


10926 


Lii^eNu 


344 


• 6 1 3 








i)6145 


LI'^FLt. 


•liH 


2SH 


293 


332 


9b1 


0016? 


LIH5TW 


♦ I4f» 


29IC 


347 


394 


367 


UlPTl 


LOAO» 


• 97tA 


147 


159 






91006 


LOAOXS 


•lllA 










lie77 


L0KR8T 


•777 


787 








00008 


LRN 


*09tA 


961 


964 






00014 


LRNUIM 


•laiiA 










11401 


101 


632 


•872 








ii4«0 


•^tti 


u*i> 


*e74 








U475 


MW3 


994 


♦ 876 








US87 


H04 


668 


*87B 








uses 


•IBS 


660 


*880 








11083 


H06 


872 


*888 








11662 


M07 


681 


*864 








11711 


N00 


686 


«886 








11746 


f^if^B 


695 


• 888 








11776 


Mie 


723 


• 890 








10249 


"11 


*ee9 


743 








1209« 


«11A 


7 38 


741 


• 892 






12U62 


«12 


738 


829 


• 894 






12»75 


«12A 


828 


• 896 








I211tf 


«13 


861 


• 8i*7 








12123 


H13A 


esp 


• 899 









472 473 476 477 488 



627 



DATAPOINT CONflOENTlAl. lNrOH**ATION • SCg PAGt I 
PAGE 29 S0HTTeST/TX7 SORT OPTIONS COMBINATIONS GfcNfcRATlON PROGHAM 



12144 


H14 


865 


• 900 








12177 


M14A 


655 


*9a2 








12230 


^^14B 


859 


864 


♦ 903 






12233 


H19 


456 


*904 








12307 


M15A 


4 54 


•906 








12325 


rtl6 


529 


• 907 








12374 


H16A 


527 


• 909 








12412 


H17 


489 


565 


«9ie 






12425 


Hi8 


59f 


•912 








12460 


H19 


29P 


•914 








10611 


HAKSOR 


679 


•ess 


696 






00012 


MAXUHN 


*lk)0IA 










01400 


MCRS 


*84IA 


123 


296 






102S0 


NAHfiXT 


444 


448 


493 


502 


517 


06715 


NM8BM0 


272 


♦283 








1^6704 


NMbFWD 


27 


• 279 








1<)462 


N0D»*V1 


647 


•659 








107S5 


'^a'fiLi 


*72P 


'/36 








10775 


M0PIL2 


731 


• 738 








10747 


NOFiue 


719 


•727 








e!73ei4 


NXTFIL 


169 


•426 








i!)725l 


NXTLl^ 


36fc 


•381 








^7279' 


NXTPRh 


26? 


267 


• 389 


397 


4i!i5 


l?l»6e> 


QpeNS 


• 36:a 


449 


453 


522 


525 


yiAf^ffifO 


OVtADl 


♦ I 09 J A 










10147 


PADeOF 


*578 


580 








10067 


PAOREC 


• 557 


559 









521 *606 713 717 728 



661 668 718 



0AT4P01NT CUNFIOfehTUv^ IsFuR-^AMON • SEE PASE I 
PAGt 30 S0hTIE8T/TXT SORT OPTIONS COmBInaTIOvS GtNfcHATiON FHUGhah 



^9^\M'l 


PU'"^ 


*94f A 












*?a00(.^ 


PF^ 


*93tA 












^ft726 


PblsTk 


274 


*287 










*3Ul«« 


POSIT* 


*49IA 












01063 


PREP» 


• 391 A 


841 










V96144 


PRMFLU 


♦ 128 


167 


170 


189 


263 


317 


<41441 


PHMOPS 


•125 


172 


3b 2 








0U«>9 


PPOTE* 


«44tA 


844 










a6i»2 


PTASLE 


*136 


149 


348 


349 


373 


374 


0U27 


PUT* 


*9eiA 


945 


949 


994 


99b 


958 


18127 


PUTEOF 


• 970 


575 










871KI0 


PUTHDH 


3C1 


• 337 










Vi i«>« 


f- u i " * 


• olt* 












t Hf^SJ 


PuTQfC 


^39 


♦ 993 










10049 


PUTSPC 


943 


*948 










01113 


READS 


• 461 A 


480 


933 








12927 


REPUV 


679 


877 


689 


691 


• 980 




00911 


RETURN 


13S 


• 152 










00010 


rtlBCVL 


«98tA 












00011 


RI6SEC 


♦ 99tA 












Hl^74 


RUN* 


*3StA 












i?ilfflf?i 


RUNX* 


« 1 e 1 A 












0tftf27 


SOFLAG 


*82tA 












is^v>i^ 


SDM** 


*83»A 












86596 


SETfel 


237 


• 239 










97^16 


5ET6T 


312 


• 314 










07K51 


setmor 


309 


•327 











328 397 309 626 



971 977 979 
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01041 SETIS 

06421 SETINX 

136610 StTKEY 

06734 SETlIM 277 281 289 *29B 

06532 SETPS 

197042 8ETREC 

136904 SETTAC 197 2a4 •il7 

10940 SPACES 

10123 SHCEOf 

1290J S»TC»«D 

06270 SPTLNK •144 385 395 399 

12514 SRTQVl 

06147 8RTPFN *132 140 S65 



10360 START 

10<»17 TBSPS 

10061 TCHKJ 

10049 TFMRS 

10O&0 TFMi*S 

01036 TPS 

1000e TPBOF* 

10K05 TPtOFS 

10^31 T»$ 

i?!ll46 TRAP* 

10i?U Th{».S 

K3615*? TSTPf.- ♦133 1S4 635 

10053 TTRAP* 



*21 lA 




185 


*190 


290 


*292 


277 


281 


227 


• 229 


321 


*929 


197 


204 


389 


• 814 


937 


• 988 


890 


• 918 


• 144 


389 


667 


• 919 


♦ 132 


149 


*625 


922 


*65IA 




• 75IA 




*71IA 




ft72IA 




• 20IA 




*62IA 




*63IA 




*67:a 




*29IA 




*68;a 




*64|A 




*133 


154 


• 73IA 
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i»9i7 


Imi 


*69tA 








10056 


Trnklli 


*74IA 








10924 


Ttetft** 


*56}A 








10042 


T««lTt 


*70IA 








074e« 


unpal<» 


*U3IA 








t»lU6 


*RITE1 


• 47IA 


47 » 


96i* 


981 


^7332 


XFREOS 


363 


368 


*4»7 


414 


00017 


xxxxxx 


«litf3IA 
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28.9 SORT OPTIONS COMBINATIONS 

SAMPLE LIST 



This subsection gives many examples of SORT option combinations. The list 
was generated by the SORTTEST program modified to write the generated options to 
a disk file. The list Includes all legal combinations cf one each of each of the SORT 
options for both the SORT COMMAND LINE options and for the LIMITED OUTPUT 
specification line. 

The ordering of the list is: 

All combinations of the SORT COMMAND LINE options. These are the options 
which follow the semicolon ; in the very first parameter string to be passed to 
SORT. 

All combinations of the LIMITED OUTPUT specification options. These are the 
options which must be given if the 'L' option is specified in the SORT 
COMMAND LINE. For each SORT COMMAND LINE which includes the L' 
option, the LIMITED OUTPUT specification lines are listed before the next SORT 
COMMAND LINE. 

The HARDCOFY HEADING specification. This Is the line of characters which 
must be given If the *H' option Is specified in the SORT COMMAND LINE. For 
each SORT COMMAND LINE which includes the 'H' option, the HARDCOPY 
HEADING line is listed after the associated LIMITED OUTPUT specification. 

The SORT COMMAND LINE options begin at the first column of the list. If 
LIMITED OUTPUT specification lines are required they are listed indented five spaces, 
following the associated SORT COMMAND LINE. If HARDCOPY HEADING lines are 
required they are listed indented ten spaces, following the associated LIMITED 
OUTPUT specification. 

Note that the HARDCOPY HEADING line when generated consists of three 
elements: 

1. The associated SORT COMMAND LINE; 

2. Ten spaces as a separator; 

3. The associated LIMITED OMTPUT specification. 

The comments in the SORTTEST program (subsection 28.8), especially page 3 of 
the program, explain the basis of the ordering of the options generation. 
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3, TU*20 

4, DTll-2fe5 

5, Ull»20 

«• U*20,» »il»60 

7» 2«»Ur» M-60 

»• **» M«»6« 

l»f Ili20/5»P,» »,1p60 

lit 20iin/5«P,t i,iw60 

12. */5iiP,« »,l»60 

13, 'ReCORQ»> »/9«P,' »,l»fl0 
Hf ll*2td/5»P|» ',1»60 

15, 20«n/5#P,t l,i*$0 

16, •/5<>p,t 'iiitea 

17. 'RECO«0-»> »/a«»P,' M-60 

18, 0Ull'-2CI 

l»f M«20|i (|1«60 

20i 20*11, » M^60 

21, *,» »,i«60 

22, »KICOHO«»> »,» »il^60 

23, U-'20/5«P,» »ili-a0 

24, 20--U/5«P,t t,l»60 

25, ♦/5»P,» »,1*60 

26, iR£CORD«P> r/9BP|t i,|««e0 
2r, U-20/5«*P,» «f l»«0 

29. 20-U/5*»P,» M»60 

29, ♦/5«P,» M»90 

30, 'ReCORO-> »/5#P,» »flp90 

31, UHU«20 

32, U«>20,( Si«60 

53, LHU-20 11*20, » »,i»60' 

34, 20*.U, » M»60 

^^» IHU«»20 20-11, » M«50 

36, i>fi V, 1-.60 

37, l.HU^20 ♦,» ',1^60 
36, »KeCORO«> i,t »,l*60 

5Si tHU»20 »RECORO*> »,« M«60 

40, M«i20/5«P,f »,l*60 

4li tMn-20 U-20/9»Pf' M»60 

42, 20-U/5«P,f »,i*i5j0 

43, lHllfi20 20-U/'5iP,» »,i*fl^3 

44, */5«P,f »,1»60 

45, LHU«20 «/5»P,» »,it-60 

46, »ReCOROw> »/5tP,» »,J-60 

47, LHUii20 »RECO«D»> «/5»P,» M«60 

48, U-2a/5l»P,i »,i*60 

49, LHIH20 n-20/5#P,» »,i«60 

50, 20wU/9«P,» 'li.flw 

51t LHU-20 20-ll/9#P,» M-60 

S>2s */5#P,! t,l*e0 

53, LHU*20 */5#P,» »,l-60 

54, 'RfeCQRO*> »/6#P,' »,l»60 
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56, 0LHU»2« 

57, U*2to,» M«»6i9 

5«, DLMll*t2B ll»20#* »rl-6l^ 

59, 2i3»n#* M«aitf 

52, 0LHU-»8I5 *'♦ t,l-6ll 

63, 'ReC0R0-> »#♦ «fl»6« 

64, OLHll»20 »HtCOHO*'> 'f» M-6id 

65, U«2ta/5»P,' »#l«»e0 

66, OLMn«20 n«20/5«P,» i,l»6l«* 

67, 2S9-ll/5"P,» ^,Xm$^ 

68, OLMU.20 23-U/5«P,» ',l-6»^ 

69, •/5«P,» M»6» 

7«, ULMn*20 */5iP,» »fl*6« 

71, 'RkCORD*> »/8«Pf' M-»^« 

72* 0LMU#2a '►UCORO'-* •/5«P|' M-6»^ 

73! ll-20/5#P,» ',l»fi« 

74J OLHll#a» U-2»/5«*P»' M-S(fi 

75, 20»»ll/5«P#' »fl*«» 

76, OLHU-'ae 2a«'U/5<*Pi' M-eei 

78, DLHll»8» ♦/t)«Pi» M»6a 

79. »HfcCaRO-^ »/B«Pi' »il*t»0 

60, 0LHll*2B MtCORO''^ »/5>»P»' M*60 
81, P9«Pll-20 
62, DP5«PU«20 

83, TP9«Pn*20 

84, OTP5«Pli»'20 

85, LP5»Pll»20 

86, n»2«J, • M*60 

87, 2»i»u,' M-ee 

88, *f» i,Ip6« 

89, iRgeORO^^ '#' 'ii*6» 

90, U«2»/P|' Sl*fi<9 

91, 20-U/Pf' ',i»60 

92, */P#» »il*fl0 

93, »RtCORO»> »/Pi' M-'eW 

94, U*20/9»P,» '#l»60 

95, 20»U/9«P,» M»60 

96, t/9«P,» Mp60 

97, »RECORO-> »/S»Pf' M-b0 
96. U»»20y9#Pr» 'il^aw 

99, 80»n/8#P,« M*60 

100, •/9#P|» »a»0» 

101, »RECORD»> '/5#Pf» »il«tJ0 

102, DLP5iPll«i'20 

103, ll«20,» »,l»60 

104, 20«»U,( M«00 
109, ♦i' »,l«»60 

106, »RtCORD»> S* M»60 

107, 11»20/P,» »,l*»60 

108, 20»ll/Pf» M'-eft' 



f^A5e 
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109 


, .*/p,« »,i«.«a 






U0 


, »HF.COR0p.> i/P, I Mi,60 






Ul 


, ii'»2id/5«p, « »,i»a0 






US 


, 2fe5'»U/5«P,» Mpa^ 






113, 


, t/SiP, ' »,l*60 






U4, 


1 'R£CORO«»> »/5»P|» »,!•• 


60 




115, 


, ii'-aia/s^p,* »iIp60 






116, 


1 2«lfn/5«P,» »|i«6» 






117, 


, */S#P, « »,1*6IS 






lie, 


1 'RecORO"*' »/5«P,» M- 


60 




119, 


, lHP5«Pll-20 






I2ia, 


1 U-20,» »,l*60 






121, 


. LMP5«Pll-20 




n«20,i 1,1*60 


122, 


► 20-11, » »,l-i60 






123, 


» LHP6«PU-i20 




20*iUr» »,l«60 


124, 


, ♦,' ',,1-60 






125, 


» LHP5»PU»20 




*i« »fi»»60 


126, 


> '»&COROt> »i» »,1*60 






127, 


LHP6«Pll»20 




»RECORO'»> »i» »,H60 


128, 


, 1U20/P,» »,l-60 






129, 


► lHP5«Pn»20 




11*20/P,» ',1*615 


130, 


1 20^11/P,» t,j„60 






131, 


UHP5«Pn-20 




20iiU/Pi' »,l-60 


132, 


1 •/?,» M*60 






133, 


, LHP5«PU*20 




*/P,' ',1-60 


134, 


, 'HtCORDw> »/P, » Sl«»60 






135, 


LHP5»Pn»20 




'RECORD*^ »/P» ' 'il-60 


136, 


, 11^20/3«P,i t,j,ia0 






137, 


» LHPe«PU»20 




U«20/S«P,» »,l-60 


138, 


, 2i?«^U/5»P,» »,lf60 






139, 


lHP5tPU«20 




20»n/5«P,» »,l-60 


140, 


*/5iP,» ',1«»60 






141, 


, UHP5«PU'*20 




*/S«Pf' • 1*60 


142, 


«RfcCORD»» »/5«P|» »,1- 


60 




143, 


tNP5«PH»20 




»RECORO*s» '/5iP, » »,l*60 


144, 


ll-»20/5#P, » «,1»60 






145, 


UHP5«PU«'20 




U*20/5»P,» ',1-60 


146, 


20«ll/5«P,» Sl»60 






147, 


UHP5»Pll»20 




20*U/5#Pj. » ',1-60 


148s 


*/5«*P, » »,l»60 






149« 


LHP5«PU«^20 




*/5#P,' M-60 


150, 


»RECORO-»> »/5<»P,' M«» 


60 




151, 


tHP8«Pll-20 




»ReCORO*> '/5#P|' ',1-60 


152. 


l)LNP5«PU-2*« 






153, 


11-20,' »,l-6!?! 






154. 


DtHP5»PU-20 




U-20, ( ',1-60 


155, 


1 2si-U,t 1,1-60 






156, 


. DLHP5-PUP.20 




20«U#' ',1-60 


157, 


r *»» M-60 






158, 


DLHP5»!f»n-20 




*i» »,l-60 


159, 


» •wecORD-> », » »,l-60 






160, 


0LHP5»Pn"p2a 




'RECORD-* S» Si-e^ 


161, 


11-20/P,' ',1^60 






162, 


Oi.HP5«Pll-20 




n-20/p,' »#i-6«^ 
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163, 

169, 
166, 
167, 
166, 
169, 
170, 

m, 

172, 
173, 
IM, 
175, 
176, 
177, 
170, 
179, 
180, 
161, 
182, 
183, 
164, 
169, 
166, 
187, 
188, 
189, 
100, 

191i 
192, 
193, 
194, 
199, 
196, 
197. 
198, 
199, 
2001, 
201, 
202, 
203, 
204, 
209, 
206, 
207, 
208, 
209, 

210, 
211, 
212, 
213, 

214, 
219, 

216, 



20fll/Pf« »il*60 
DLHP9«Pll»2J^ 

*/P,» M-60 

OWHP9»Pll-20 

'H&CQRO-> »/P-» » 



,, •,1-60 
OlHP9«Pll»20 
11»20/9«P,» »,lw60 

OLHP9«Pn'»20 
20'»ll/9«P,» Mt60 

OlHPSiPl 1-^20 
*/5«P,» M»60 

DUMP6*Pn*20 
»ReCORD*> »/9»Pi» »fl»6itf 

OUHP9»Pll-20 
ll»20/9#P, » »|l<*60 

OlHP9*Pll*20 
20-ll/9«P,» M»60 

DUHP9«PU»20 
*/5<tP,» Sl»60 

DI.HP9-PU-20 
«W£CORD-> »/9#P,' »,l»60 
DlHP9«Pilt>20 
S9«8tl»20 
OS9>S11*20 
TS9»Sll-20 
DT89«S11»20 
t89>Sll<^20 

U»20|* 



il«60 
20*11,' (,1«60 
♦ ,f t,l«i60 



»ReCORDf^ 

n»20/p,« 



S' 



» I l»6w 



|«60 



20»11/P|« »,l*60 



*/P, 



I I 



l»6i 



RECORO*> »/Pf» M-60 



ll*20/9«8,' 
20-ll/9»8,» 



M-60 
*pl«60 



*/9s8,( M»60 
»ReC0PD-> »/9»8,' M-60 



llii>20/9«(8,* 
20-ll/5#S,« 



»,l-60 
t •1»60 



*/5i*8,' Sl»60 
»RECORD*> »/9#8,» 
UlS9«Sll-20 

11«20|( M-60 



»,!-«>« 



20-11, » M-60 
*, « »,l-60 
tHCCORO-> 



S' 



1-60 



•20/P 
•ll/P 



11- 
2«>< 
•/P,' M 

tRECORO-> 



t I 
I f 



1-60 
1-60 



>60 
»/P,» 



» ,1-60 



ll-»20/9»8, ' 
20p11/5«S, ' 



',1-60 

' ,1-60 



2(^-ll/P,« M-60 
t/9,^ »,l-b0 



I RECORD-* 

ll-20/9«P, 

20-ll/9»P, 

*/9«P,» «# 

'NECOWO-* 

n-20/5#P, 

20-ll/9l»P, 

•/9«P,» 'i 

'HfcCOR0-> 



/P,' ',1-60 
',1-60 
',l-6ifl 

*6?i 

/»«P,' »,l-S^ 

«, 1-60 

♦ , 1-60 
• 60 
/5#P,' ',1-60 



PAGK 
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217, 


*/5iS,» Mw60 


216. 


»KECORO*> »/5f8#» »ai»645 


219, 


U*20/5O8i » *il*i60 


220, 


2(^-U/5«»S,t »,1»614 


221, 


♦ /5#d,» M*.6« 


222, 


»»eC0«D^> »/5*f8,» M»6fcJ 


223, 


LHS5iSU-2fcl 


224, 


11-20, t »,l<i6i 


225, 


UH83«$U»20 


226, 


2i^-Uf' 'ii^ee 


227, 


LHS5«SU«20 


228, 


*, f Mp60 


229, 


tHS5«8U»26! 


230, 


'»ECORO*> ♦, » «|i*6« 


231, 


LH89«8Uip2(a 


232, 


U-20/P, » »,i*6ia 


233, 


LMS9i8U»2» 


234, 


2«-ll/P,» »|l*60 


235, 


LHS5«SUi>20 


236, 


*/P,» M«60 


237, 


LHS5»8U'-20 


238, 


'RECORDw> »/P,t »fl-.60 


239, 


LMS5«S1l»2<a 


24(9, 


U-20y5«S,« »,lw6i(? 


241. 


IH35«SU*20 


242, 


20-ll/5«$,» «,l»6e 


243, 


iMS5»8U»20 


244, 


♦ /5«S,' Sl''60 


245, 


I.HS51SU-20 


246, 


► '^<eCO«D*> »/5»S, » ♦# l-wgB 


247, 


l.HSS»8nf-20 


248, 


, U-20/5<tS,» Mi»6li3 


249, 


, UMS5«Sn«20 


250, 


, 2(a».U/5#S,« Si»6e 


251, 


^ LHS5*3U»20 


252, 


1 */5«»Si» M-60 


253, 


> IHS5«3U*20 


254, 


» »NECOR0-> »/5#S,» M^60 


255, 


, UHS9»8n*20 


256, 


, OlHS5«8U-20 


257, 


\ 11-201 • f,i<f60 


258, 


, 0lHS5«SU*2!a 


259, 


, 20-.ll,t M*60 


26k9, 


, DlH59i$n»20 


261 


1 *#» M-60 


262 


, DLH89«S11«20 


263 


, 'HkCORO«» »,» »,l-6k. 


264 


, OUhS9»8U-20 


265 


, U-20/P,» M»60 


266 


, DLMS5«8ll^24 


267 


, 2fe*-ll/P,' Mi«60 


266 


, DIH$5«8U»2« 


269 


• */P,' M-60 


21^ 


, DlHS5«Sll-2^ 



11*20, » M-60 
20*Ui» Sl*60 

»RECORD-*> '#» M«60 
IIp20/P#» M-60 
20pU7P,» 'a'-ft^ 

»KECOND*> '/P,* M-6KJ 
U»20/5»S,' M-60 
20«'ll/5aS| » M-60 
•/5i8# « »,l»60 
»RfCOHr.*> »/5«S,' Sl»50 
U«i20/5I#3,» M-6«? 
20»ll/5<i^S,' M-6i4 
•/5#5,^ »il*6W 
'RECORPwfr »/5«»S,' Sl«60 

n-20f» M*60 
20»llf » M*60 
♦ ,f »,l-.60 

»RECORO»i» S» M-60 
ll-20/P,» M-60 
20»il/P?« M-60 

• /p,' »n»60 



PAGE 
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271. 

272, 

273. 

274. 

275. 

276, 

277. 

278. 

279, 

280. 

281. 

282, 

283, 

284. 

289, 

286. 

287. 

288. 

289. 

290. 

291. 

292. 

293. 

294. 

295. 

296. 

297. 

296, 

299. 

300. 

301. 

302, 

303. 

304, 

505. 

306, 

307, 

308. 

309, 

310, 

311. 

312. 

313, 

314. 

315. 

316. 

317. 

318. 

319. 

320. 

321, 

322. 

323. 

324. 



'RECORD** »/Pf' M-60 

OtM85«Sll»20 
ll«*20/9>5,t »a*«0 

OLH89»8ll»20 
20«ll/9«$i* M»60 

DlHS9i8U*20 
•/5«S,» »,1»60 

OlH$9«8il*20 
»H€CURO-> »/5»Si» M«»60 

OLH39«8n-'20 

u«20/5«tS|( M'-ea 

OIHS9>8U*20 
20»ll/5#S,» »fH60 

OLH89^3ll»20 
*/5#S,' SH60 

DLhS9aSU»20 
»HfcCORD*» »/6*»»»* M»6'fl 
OLHS5bSU»20 
P5«>Pllf20 
OP5*»PU*20 
TP5#P11^20 
UTP54IPI 1*^20 
LP5l»Pli*20 

U-20,» ',l»60 
20-11 r« M-60 



S' 



1*60 



Vil«60 
»#J-60 



♦,» •,l«60 
»«tCQRD«> 
U«20/P» ' 
20«ll/P# ' 
♦/P> ' »#l-6W 
»R€CORO«»> »/Pf» M^60 
U-20/5»P,» ♦fl«'60 
20*U/5»P,» M-60 



•/5«P, « 

• la r: *» »^ es "^ 



M-60 

M. t 4 gt mk tSk I 






llf»20/5*P,» »fli»60 
20-U/5*tP, ♦ »,l*60 

• /5*P, » M-60 
»RECORU-> »/5#P#» M«b0 

OLP5«»P11«»20 

ll»20,' M«60 
20i»ll,' M-60 
t,» »,l-60 

»RECOWO-> S» »|l-«k« 
ll«.20/P,» M-60 
20-n/P» ' «,l*60 

• /P,» M-60 
•»ECORD»> »/P»» »il"*60 
Il»i20/5»P,' »ii»60 
20»ll/5«P,» »,1»60 
♦/8»P,' »,l-60 
»RECORO-> »/S«Pf» M-(5ia 
U-20/5<fP»' M-»60 
20-ll/9i*P, » »,l«i60 



«ReCORO»> '/Pf' M-60 
lli20/5«8»' M-60 
20»ll/9«3,» M-60 
«/5>3f* irl**60 
»RECORO»> »/5»S, » ',l-6if9 
U*20/5<»Si » M-OkS 
20i.U/5i>Si' M*«»fe5 
♦ /5«5»' *fX^b(6 
»R£COttDw> «/5#5,» '#1-60 
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425 

i'ib 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 

349 

350 

351 

352 

353 

354 

355 

356 

357 

358 

359 

36«9 

361 

362 

363 

364 

365 

366 

367 

366 

369 

67d 

371 

372 

373 

374 

375 

376 

377 

378 



*/5«P,» »ii«60 
'HECORn»> »/5#P,' M-60 
LHP5#PU-2W 

LHP5«»PU'-20 
2«-U,» M*60 

LHP5#PUp2fil 



t. » I 



#1-60 



LHP5#PU»20 
'KeCOR0^> ',» M«»6id 

LNP5<»Pii»20 
ll'-20/P,» »,iP60 

LHP5«Pn«»20 
2»*U/P,i »,l«6Ki 

LMP5*Pll-2i(S 
*/P#» »il«60 

LHP5KPU-2C5 ^ 
»K£CORO»> »/P,» »,||»6« 

LHP5l*Pll»20 
n»20/5»P, » »^l*60 

LHP5«»PU-20 
20*U/5«P,» M«6id 

LHP5<»Pll-20 
*/5»P,' '#1*60 

LHP5«>PU*20 
'ReCOHO-'* V5»P|» M«<60 

LHP5#PU«20 
U«20/5#P,» »,l«6B 

LHP5«»Pn«20 
20-ll/5i»P,t t,j,60 

LHP5*»Pil«p20 

*/5l?P,t M«60 

LHP5I»PU''20 

»RecoRo-> »/5*tP,» M-ea 

LHP5IIPII-20 
OLHP5#Pll^20 

U»20,t »,l*60 

0LHP5*lPll»2a 
20«»n,» ',1*60 

DLHP5#PlJp.20 
*,» t,lii60 

OLNP5#PII«p20 
»RtC0R0*> «,» 'rl-60 

0LHP5»PU-2« 
U«»20/P,' «,l-60 

0LHP5l»Pll^2« 
2i?'»»n/P,» »,l»60 

DLHP5#PH'-2a 
•/P»' M-80 

DLMP5#Pn»2^ 
•WfcCURD-^ '/Pi' M^ekJ 

OLHPS#PU'»20 
ll»2»/5«P, < ',l«»50 

DLHP5«Pllf20 



ll'i2^?^» M«»6^ 
20pUi» »,H6i^ 
*#» Sl-^ei* 

'RECORD**' '#» ',1«6;4 
U«20/P|» ',i*6ir3 
20tll/P, » t,l*6H 
*/Pf» Mf6i<} 
'RECUROwi* «/Pi» 'fl-60 
ll»20/5iiPf« »,l»6td 
20-n/5»P,» M-6*a 
♦ /5«Pi' M-^eta 

«RCeORD»> »/5iP, » M«6kJ 
ll*20/5#P,» »,l-6i8 
20«U/5«»P, » M-60 
»/5»P#» »il*6ts 
»RECOWO*> «/5«»P,' »fl*6to 

Ui»20f» M-60 

20«ipUf ' M^ed 

*#♦ »il*6ia 

'RecoRD»> »#» M-eii 

ll»20/P,» M»60 
20pll/P,« M-60 

•/Pi» »»i-eM 

»RfcCQRi)«> '/P*' 'fl«6^ 

ll«i20/5«Pp » ',l-f»k^ 
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379« 20-»l|/9*P,« ',li»6e 

360. 0LHP5«>PU'»8« 20-n/9PP,» M-6W 

381. t/S-P,* »,l*60 

362i QLmP5#PU*»20 t/SSiP,' »,l»O0 

383, »»ECORD-> '/S^Pf* Sl»6(d 

384, OL.HP5#PU»20 »ReCORD«i»» »/5«Pf» M-60 

385, U»8ld/3#P,» «il«60 

386, 0lHP8#PU»a« U*20/5*P>» M»60 

387, 20»U/9<»Pp» »#l«ew 

388, Ol.HP9#PU«20 20*ll/9«P»» M»60 

389, •/5<tP, » M*6« 

390, OlHP5#Pn-20 ♦/9#P,» Sl-60 

391, 'HECORO*^ »/9»P,» »,l«Ci0 

392, DLHP9#PU»20 »RECOHD-> »/6<»P#» M^-Sia 

393, S9««SU«2» 

394, U89#SU»20 
399, TS9«8U«20 

396, UT89#8U*'20 

397, U39«»$np20 

398, U<»20»* M*60 

399, 20«U,( ryl»60 

400, *,! (||»60 

40'l, »HECORO«> «, » »,|-60 

402, U*20/Pi« M«60 

403, «0-U/Pi» 'il-60 

404, •/?,» M-ea 

409, 'ReCORO»> »/Pi» M-te^ 

406, U«-20/9«S,* (|1»60 

407, 2i«»U/9«8,« «,l«60 

408, t/giSi' ♦,l»60 

409, «RCCORO-> »/9»S#» »|J»60 

410, U*20/9i»S, I Sl»60 
4U. 2i«l-U/9#S,» »|l»60 

412, •/9#S,« »|lii60 

413, fRiCORD-» i/SASf* *fl«e>fc) 

414, QLS5«Sil-20 

419, 11*20, < Mf*60 

416, 20911,* (,1«60 

417, *,» t,i.60 

418, »ReCORO*> ',' M«60 

419, IU20/P,» »,1«60 

420, 20*11/P|< M«60 

421, »/P,' M»60 

422, »RECORO»> »/P#» Sl'60 

423, 11*>20/9bS,( *ft»60 

424, 20*U/9*Sf« Mii60 
429, */9»5,' ',1»60 

426, »RECORO^> '/9»8f' »,l»«)0 

427, ll^20/9#S,» M«»60 

428, 20i-ll/9«»S,( M*60 

429, t/5<»S,' M-60 

430, »HECORO-> »/9»»8,» M-6K 

431, UNS3«Sll-20 

432, 11-20,' M«60 



PAGE 
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439, 


. LH55I»5U»20 


434, 


2»«ll,» ',1*60 


435, 


1 i.Hfi»5ltSU*20 


436, 


1 *#' M-60 


437, 


) lHS5#$n»20 


436, 


1 'RfcCORD»> »,» »,l«-6t3 


439, 


» LHS5#3n<^20 


440, 


, 11-^20/?, » »,l-60 


44!, 


1 UHS5«»SUp20 


442, 


1 20^U/P,» »|Ip60 


443, 


► lHS5#8n-20 


444, 


1 */Pi» M-60 


445, 


» tHS5«Sllp20 


446, 


» 'RtCPRO-> »/Pf » M»60 


447, 


, UH85#Sl 1*^20 


448, 


» ll»20/5iS|t Sl»60 


449, 


, tHS5#8U*20 


450, 


► 2i?!-»U/5*5|» M»60 


451, 


LH85<ISlli-20 


452, 


*/5«8, ' Sl-60 


453, 


INS5II811P20 


454, 


» 'R£CORO''> »/5«S,» M-»60 


455, 


. UH55#8Uw20 


456, 


> tl»20/5«»S| » »|1»60 


457, 


1 INS5«8U»20 


458, 


, aa^-u/s^s,' »,i»60 


459, 


» LH85<»8ll»20 


460, 


, */5#5,» »,1»60 


461, 


1 IH6SI»311<»20 


462, 


, '«£CORO^> »/5#S,» «, l-6« 


463, 


► LHS5«Sllw20 


464, 


1 QLHd5«$U»20 


465, 


, n->20,i <,1<«60 


466, 


r 0UH89#SU«*2a 


467, 


► 2^*llr» M*60 


466, 


1 OLHS9«dll<»20 


469, 


t *,» ',li60 


470, 


1 DLHS9«»SU<-2d 


471, 


, «R£COHO-> ',« ',1-60 


472, 


, OIHS5#SU«20 


473, 


1 lli'20/P,» i,Ip60 


474, 


, DtNS5#8tlfi20 


475, 


. 20-U/P,» t,l#60 


476, 


» 0lHS5«SU«i2a 


477, 


1 •/?!» »ll»60 


478, 


, OLHS5iSn»20 


479, 


, '«fcCORO*> »/P, » »,l-60 


460 


, OLMS5«»5U»20 


481, 


, ll''20/5«5,» »,1*60 


482, 


OLHS5#Sllt«20 


483, 


, 20-U/5«S,' »,1»60 


484 


, DLHa5«SU««2(d 


485 


, */5«S,» »,l-60 


486 


, DUHS9«Sll-20 



U<i20,' Sl«60 
20-ll«,» Sl-60 
*f» t,l<.60 

»REC0«D«5^ N' »,l*&>a 
Ilp20/Pf » ',l"«v' 
20«p.U/P,» M»60 
*/P,» M-60 
♦l»ECORD-> '/P,» M-60 
U»»20/59S,» M-60 
20-n/5iS, » ',1-60 
*/5»8,' ',1-60 
»RECORO-> '/5»S,» ',1-60 
U-20/5*>Sf» ',1-^60 
20-U/5#8,' ',1-60 
♦ /5<tS, » ',l-t60 
'RECORD-^ '/5»S# ' »,l-60 

11-20,' ',1-60 
20-lli» ',1-60 
*,» ',1-60 

'RECORO-s* », » ',1-60 
ll-20/P»' '#1-60 
20-ll/P,' ',1-60 

•/Pf » ',l-t50 

»RECORO*> »/P#' 'fl-60 
11-20/53$, ' •,l-60 
20-U/5»Sf * ',1-60 
*/5«S,' »,l-6(? 



PA«e ti^ 



3P«T0Pn$/TXT — 50HT UP^ IONS COMBINATIONS SAMPLE LIST 



Ad7 

468 

4d9 

49\fi 

491 

492 

493 

494 

495 

496 

497 

498 

499 

500 

501 

502 

503 

504 

509 

506 

507 

509 

909 

510 

511 

512 

513 

514 

519 

516 

517 

518 

919 

520 

521 

522 

523 

524 

525 

926 

927 

928 

929 

530 

531 

532 

533 

534 

535 

536 

537 

538 

539 

540 



»RfcCORO*> ♦/9»S,» »,li»b0 

DLH55«SU^20 
U«-20/5«»S, « V,l^60 

DtHS9#8n»20 
2fe5-U/5#8|» M*60 

DtH$9«811»20 
'»/9<»S,» Mf'60 

DLHsg#$n»20 

»WfeCORO-> '/9*»8,» »,l«i60 
DtHS9#8n-20 



»RECORD*> '/5»3,' M-6i^ 
U«p20/9#$,' si-ei? 
20»»U/9»$,» M»6kfl 
♦ /9#8|» Sl»60 
»RECORO*> »/5«>S,' »,l-6i3 



20-U 
U20-1 
T20^l 
UT2W* 
U20P1 



1 
I 

U 
I 



U»20,' », 
20-U,« ', 

♦ ,♦ M-ea 

•ReC0RD-> 
U«"20/9«P, 

20tiU/g«pf 

#/9»P,» ', 

»ReC0R0-»> 
U»20/9#P| 

20»ii/g#p, 
*/g#p,» », 

•RCCORO*> 
O120»U 



u 

201 



•20, 



I I 



f 



»,i 1,1-60 



M»60 

M«60 

• 6k! 

/9»P,» »,lw60 

irlf60 

(,1p60 
«60 
/9#P,» »|l»60 



»HECORD»> 

U«20/9«P, 

20itU/9»P, 

•/g«p.» ». 

»RECORO»> 
U»20/9#P, 

20«U/9»P, 
♦/9#P,i », 
»RECORD-> 
IH20»U 

ll»20|' S 

L.H20« 
20pll,» », 

LH20-U 
*,» »,l-60 

LM20»U 
*RECORO-> 

UM20*ll 
IU20/9«P,» » 

LM20*H 
20p.n/5«P,« »,1"60 

LH20-11 

*/9»p,» si«e« 



*60 
-60 

,t i,i»60 



|f>60 



f I 



*f 1«60 
•60 
/5»P, 

* ,1*60 
Mi>60 

• 60 



/9«fP 

• 60 

• 60 

. f I 



f t 



l*i60 



1*60 



1*60 



•60 
I 

<*60 



»r' 



,1«60 



20-U#* »#l*60 
*#» »,l»60 
»R(:C:ORD»> 
U-t^0/9«P,» »,l*6'^ 
20*3l/giP, ' »,i-60 



',' M-60 



PACE n 



SORTOPNS/TXT p.- SOHT OPTIONS C0H8INATI0N8 5AMP(.fc LIST 



541 
542 
S43 
544 
S45 
546 
547 
548 
549 
550 
551 
592 
553 
554 
555 
556 
557 
558 
559 
560 
561 
562 
563 
564 
565 
566 
667 
560 
569 
570 
571 
572 
573 
574 
575 
576 
577 
578 
579 
560 
561 
582 
583 
564 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 



LH20"»U */5iP,» », 1*645 

'R6:C0K0-> V5»P|» ',l-6i^ 

tH20»U 'R£CORDp> »/5fiPf» M-6fc^ 

U*2i(J/5«P,» si^fse 

IH20*.U 11*»20/6<»P, » »,l«6^ 

2i?>*ll/5»P,» M-60 

LH20*»U 2e-ll/5«P,» »,l*8i^ 

*/5«P,» »fj«»60 

I.H20-U •/5#P,f »,l-6K 

»R£CORD-»> »/5#Pi » Sl^e^ 



'RECORD^> '/S#P, ' M»6(a 

U-20,» »,if60 
20-11, » »il»80 
• i » ',l«»60 

»RECORP-> S' »ii-6«» 
ll-20/S»P#« M^ea 
80-li/5«P#» M-60 



LM20*11 
OLh20»11 

11-20, » M-60 

OUH20-11 
20-11, » »,l-60 

DLM20«ll 
*,» M*i60 

'RECOHD-> »,' ',1-60 
OLH20»ll 

U-20/5-P, » «il-<^0 

OlH20iPU 
20«ll/5«P,« »,l*60 

OIH20»11 
•/5»P,» »,l*60 

Dl.rt20*U t/S-P,' M^O* 

tReCQROi-^ «/5«P,» M«e0 

OLH20tll »RECORO'^> » /8«P, • » , 1»60 

U(p20/5«fP,( *,1«60 

Ot.H20i»ll ll-20/5#P,» M'le^ 

20-»ll/5»tP, I Mf»«0 

DLH20-U 20-U/5#P?» M-60 

♦/5«P,« «,|»60 

DlH20»n K/tUft^ »,l-60 

•«tCURO*> »/5«tP,» »,l-60 

OUH20-U »R6C0R0-> '/5#P,' ',1»60 

P5iP20wU 
O'P5»P20i»ll 
TP5«P20-ll 
OTP5iP20-U 
l,P5»P20«U 

11-20,* M«60 
20-11,* •,1«>60 

*,» »,i*e0 



'RECORDii* 
11-20/P, » 
20-ll/P, « 
♦/P,» »,i- 
»RECOROi»> 
ll-20/5-P, 
20-ll/5«P, 
*/5ip^i I. 

»RECQRO*> 
ll-20/5«P, 



,» »,l-60 

,1«»60 

,1»60 



/P,» M-60 

' 1 1-60 

*il«>60 
••60 
/5«P,» ',1-60 

»,l-60 
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595, 


20-U/5<»P,» M*60 








5901 


t/5#P,» Sl-60 








597, 


»«tCORO-> '/SluPf' »,1«» 


60 






590, 


OIP5»P80»11 








599, 


ll'^S^r* Sl"*60 








600, 


20-11, » 'il-»60 








601, 


•,» »,i»e0 








602, 


'ReC0»0»> »i» •,l«60 








603, 


ll»20/P, » Mf«60 








604. 


20-ll/Pi • «,l»60 








605, 


*/P, » M»60 








606, 


»»i£co«o-> »/pf » M-tea 








607, 


ll«20/5»P,» M»«0 








606, 


20»11/5»P,» M»«0 








609, 


♦ /5iP,t t,l«»60 








610, 


»RECORO-> «/5«P,» M't 


60 






6U, 


U-20/5#P,» M»60 








612, 


20**11/5#P, ' *f 1*60 








613, 


♦ /5#P,» Sl«60 








614. 


»RfcCORD«> V8<»Pi» »»!- 


60 






615, 


iHP5»P20-ll 








616, 


ll-20i» M»60 








617, 


LHP5«P20»ll 




11p20,» M 


l«»60 


610, 


20-llf' »,lw60 








619, 


, LHP5»P20»11 




20^11,* M 


L»6M 


620, 


» *,' ',l»60 








621, 


, LMP5»P20*ll 




♦ #» M«60 




622, 


, 'RfcCORD-> »,» M«60 








623, 


, LHP5»P20-ll 




»RtCORO«» 


1,1 »,l«6ie5 


624, 


, U»20/Pi' M»60 








625, 


, LHPSbP20*11 




ll-20/P,» 


'»l-6kS 


626, 


, 20-U/P# • M"'60 








627, 


, tHP6«P20pll 




20-ll/P,* 


M*6P 


628, 


, •/?, ' M-60 








629, 


, tHP5«P20«lS 




*/P-t i.ip/ 


5fe} 


630, 


, »RtCORD-> »/P,» M'»60 








631, 


» LHP5«P20»U 




»RECORDp> 


♦/Pf« »,1-»6W 


632, 


, 11»20/5»P,» Sl«i60 








633, 


, tHP5«P20*ll 




11p20/5»P, 


1 f,l-'60 


634, 


» 20«»U/5tiP,« »#1»60 








635 


, LHP5»P20«»ll 




20*ll/5«P, 


1 i,i-6«tf 


636 


, t/S^P, ' »,lw60 








637 


, LHP5»P20»'ll 




♦/5«P,» », 


l«60 


630 


, 'ReCORD*"* »/5«P, ' M« 


60 






639 


, LHP5iP20'»ll 




»REC0HO*> 


»/5»P,» M-6W 


640 


, 11«"20/5#P,> *rl«>60 








641 


, LHP5«P20»11 




ll-20/5ltP, 


f si-ew 


642 


, 20p11/6«P,( t,|«e0 








643 


, UHP5«P20«ll 




20-ll/5#P, 


' «il*6i<5 


644 


, t/S^P,' »,1*60 








645 


, LHP5«P20pll 




*/5#P,» », 


i^e^ 


646 


. »RlCOWD-> »/5l»P,» M* 


>60 






647 


, LHP5»P20pll 




»ReCORO«> 


•/5#Pr' M-6I(5 


648 


, DLMP5«P20-ll 
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649, 




n-^2l3,» M«6«) 


651?, 




DLHP5«P20»n 


651, 




2i6^lXf^ M«60 


652. 


^_ 


DLHP5«P2(fl*rn 


653, 




*,» ',1p60 


654. 




DlMP5»P20»ll 


655. 




'WEcoRD-> »,' M^-ea 


656, 


\ 


DUHP5iP20»U 


657, 




n-20/p,» M^pfiu 


658, 




DLHP5iP20«»n 


659, 




20-.U/P,* M«»60 


660, 




OIHP5«P20'»U 


661. 




*/P»» »il«p6i 


662, 




DUMP5«P20»'n 


663, 




'RecoRO-^ ^/?, » M*e0 


664, 




OlHP5«P20wn 


665, 




U-2(a/5»P,» »,l»i60 


666, 




DUHP3«P20«n 


667, 




20«ll/5«Pr» »il»60 


668, 




OiHP5«P20»n 


669, 




♦ /5«P, » »il«i60 


670, 




OlHP8«P20»n 


67i, 




'RECORO-* V5iP|» M»60 


872, 




OUHP5iP20iiU 


673, 




ll«20/5#Pff M»60 


674, 




OihP5«P80»ll 


675, 




20*U/5«Pi» UX»^^ 


676, 




OLHP5«P20»U 


677, 




♦/5<»Pf' M«e0 


678, 




OUHP5tP20fiU 


679, 




»RECOROp> t/5#P|» »,l»60 


680, 




oiHP5tipa0«»n 


681, 


S5bS2»»U 


682, 


US5« 


S20-U 


683, 


T85« 


S20PU 


684, 


0TS5 


«$20-U 


685, 


, IS5» 


820- U 


686, 




11120,^ M»60 


687, 




20fll,» M«60 


688, 




♦,» »,1^60 


689, 




|R£C0HD«> S* f|li»60 


690, 




U«20/P,» »,l»60 


691, 




20*n/p,» »,iw60 


692, 




♦ /P, » Mi»60 


693, 




»N£CORD»> »/P,» M-e0 


694 




n*<20/5«S, ( t|l«*60 


695 




20oU/5>S, 1 t,ip9(0 


696 




♦ /5«3,» Sl»60 


697 




»RECORO-> »/5iS,« ',1»60 


698 




llp»20/5«IS,» M-60 


699 




2W-U/50S, » »,l"-6M 


700 




*/5ftS,» »jl*6iii 


701 




»WE.COHD-> »/5*5,' M«60 


7fc52 


I OLSS 


»»920-U 



u«'2w,» tfi^-ea 

20<pU,» »,l*6« 
*i» 'fl»60 

»RECORO-> 'f' 'a*6!d 
U«20/P#* M'&^ 
20-pU/P,» M-6^ 
• /P,» Sl«60 
»RECORDi-> »/P»' M-60 
U»20/5»Pf ' M-ew 
20i»U/3»Pr' M*60 
*/5"P>» «<l»b0 
»RCCORDp> »/5»P,' M-60 
U''20/8iiP. ' M»60 
20'»M/5<»Pf » 'il«60 
*/5#Pf' Sl-b^ 
»RECOR'Ji»> »/5»P,' 'fl'-ea 
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703, 


» ll«20»f M-6ft) 


704, 


► 20-11,' M*60 


705, 


► t, 1 1 , 1-6M 


74d6, 


► 'RCCORO"> »,» M-60 


707, 


1 ll»20/P,» M-60 


708, 


, 20»»U/P,» Mi»60 


709, 


. ♦/P,' »,l-60 


710, 


, »RgCORO»> »/P,» Sl»60 


nXi 


. llf'20/5BS,( M»60 


712, 


, 20»ll/5«S,» »,l*-60 


713| 


•/5»3,' »il»60 


714, 


'«eCORO«> '/5«S, » M«60 


715, 


, ll-20/5#8,' M*60 


715, 


. 20«ll/5«»S,t Mf>60 


717, 


r •/5#S,» M»60 


718, 


, »ReCORO-> '/5«8,» M«»60 


719, 


, LNS5b820-'11 


720, 


, ll«20,t M*60 


721, 


, LH85B820«n 


728, 


» 20»11,* Sl<»60 


723, 


) LHS5«S20»11 


724, 


, *,» M'-60 


725, 


, LHS5«820*U 


726, 


> »ReCORO»> ',» »,1»60 


727, 


1 LH85«820iiU 


728, 


, U-'20/P,» M«»60 


729, 


1 LNS5aS20<»ll 


730. 


, 20»11/P,» »,l»60 


731, 


, UHS5«828»n 


732, 


, ♦/P,» M»60 


733, 


1 LHS5«820-U 


734, 


, »R6C0RD-> »/P#* M-60 


735, 


, LHS5b820»11 


736, 


1 U-20/5>3, t t,|.60 


737, 


^ LHS5s$20»U 


738, 


t 20-U/5B8,* *,1«*60 


739, 


1 LHS5«820«11 


740, 


, */5»8, » »,l*»60 


741 


1 UHS5«820<«U 


742, 


, »RtCORD«> »/5»8,» ',l«itt0 


743 


, LHS5iS20«^U 


744 


1 ll-20/5#S,« t»l«i60 


745 


1 LHS5sS2e«'ll 


746 


, 20-ll/5#»S,« »,1p60 


747 


. LMS5t820»ll 


749 


, */5«S,» M»e0 


749 


1 LHS5«S20«»11 


750 


, ♦RaC0RD-t> »/5i8»» M*b0 


751 


1 LHS5>820i>ll 


752 


, QLHS5i$20»n 


753 


, 11-20,' ',lii60 


754 


• OLHS5«820«-ll 


755 


, 2fc«-ll,» ',1-60 


756 


1 DLHS5iS20i»ll 



Uf>20,i *,1<*60 
20«n#» M»60 
*,» »,l«»60 

»RECORD»> 'f' 'fl-6H 
ll»2kJ/P,» », 1-6*0 
20-ll/P,» M-6C* 
•/Pf» »,l»60 
»«ECURD»> »/Pf' M-6i 






20-11/518, » »,l-6;fl 
• /5«S,» M-60 
»RECORO-» »/5»S,» »,l-60 
U»80/5#8,' M-6<d 
20-ll/5#8,» M-60 
*/5li8,» M-6ia 
»ReCORO-> '/5*<S, ' ',l-6ir9 

ll-20»' »,l-6^ 
20*11,' ',1-6^ 
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797 

750 

759 

760 

761 

762 

763 

764 

765 

766 

767 

760 

769 

77(d 

771 

772 

773 

774 

775 

776 

777 

778 

779 

780 

701 

702 

703 

704 

705 

706 

7%7 

700 

789 

790 

791 

792 

793 

794 

799 

796 

797 

790 

799 

800 

801 

802 

803 

804 

805 

806 

807 

808 

809 

810 



I I 



«tCORO*i> 



fl-60 

Oi.H$59920' 



n 



s» 



I 



0LH86i$2epU 
Uw20/P,t Si*60 

01HS59S2&OU 
20t»ll/P,t 1,1*60 
OlHd5«$20»>n 



1«60 



•/Pi 



f I 



l»d0 



DLH09»820fPll 



'«£CORO»> »/P,» »#l«»60 
QUH899S2e»U 

U»20/5«8| • 'il»60 
DtH39«020-n 

20*U/9«S, » »ii«»60 



|-*60 



OUH89«020ii'U 

• /5»8,» %l»60 

DtH$5«820«il 
»RECORDi»> »/9»Sf» 

OLHS9*820»I1 
ll»20/5#3|t «,l«60 

OLHS9»820»n 
20*11/9#S, » »,l-«0 

DUM89«820»U 

• /5<*8,» »il»60 

Oi.M89«S20<*n 
»KECOND-> »/9*Sf» M-60 

OIHS5«S20»11 
P5«fP20»ll 
OP5#P20«fll 
TP5«P20»11 
UTR5#P20»U 
tP5wP20»U 

u»20,t t,|»e0 

20«»ll,» »,Ip60 

*i» », i»e0 

««eCORD»> »,» M-60 
U»20/P,» »,Ip60 
20iill/P,f i,l«60 
*/P,» ',l»60 



»PeCORD»> 
U»20/5«Pf 
20«U/5iP, 
*/9»P,» », 
'HeCORD*> 
Ui»20/9#P, 
20fi«ll/5#P, 
♦ /5i»P,» », 

»»ECORO-> 
OLP5«»P20'»U 

U-20,» ', 
20-11, » S 
*#» ',1-60 
'HeCORD-> 



/Pi» 
Mf«60 
M*60 

-60 
/5»P,» 

I 

I 



l«»60 



1-60 



l»60 
1««90 



-60 

/5#P,» «,l-60 

•60 
-60 



•#» 'il-60 

»RECgRO»> S' 'fl-60 
11-20/P, ' »,lPb0 
20-ll/P,i t,i,t.0 
*/Pi» »flw60 
»RECORO*> '/P#' M-60 
li»20/5"8i » M-60 
20-11/918, » t,i,5S/j 
t/9P8p» M-60 
»RECORa-> »/5«a,» M-60 
n»20/9#5,» M-60 
20-U/S«»8f » M-60 
*/9#8f* t,l*60 
»RECOHD-> »/S«3,» M-60 



',' 



I 



1-60 
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8Ui 


U-20/P,» «,l-60 


812, 


80*U/P#' Sl«60 


813, 


*/P,» M-60 


SH, 


'«fCORO-> »/Pi» M»60 


819, 


ll*20/9«P,' M»'6fc» 


816, 


20»ll/9»P,» »,l«60 


817, 


•/9«P,» »|l»60 


818, 


^RgCORO-* »/9»P#' »,l»60 


810, 


U*20/9<»P#» M*60 


820, 


20»ll/9#P,» Mii60 


821, 


• /9I>P,» »il»60 


822, 


»RECORO-> »/9#P,» 'il»60 


823, 


LHP9»P20-ll 


824, 


ll<i20r* 'tl«>60 


829, 


LHP9lfP20*ll 


826, 


20*11^1 M<»60 


827, 


bHP9iP2e»U 


828, 


*,» M-60 


829, 


LMP9«»P20^n 


890, 


»RCCORO-> «i» M-61.5 


831, 


LHP9MP20P11 


832, 


11«»20/P,« »,l»60 


833, 


LMP9l»P20'-ll 


834, 


20»U/P,« »,l»60 


835, 


LHP9#P20-ll 


836, 


, •/?,» »,l«»60 


837, 


, LHP9#P8e»ll 


838, 


t »«CCORO'»> »/Pf ' M*60 


839, 


, LHP9liP20»ll 


840, 


> n*20/9»P#» »,l»60 


941, 


, LHP9#P20»'ll 


842, 


, 2»»n75iiP,» »,lfp60 


843, 


, LHP9#P20*U 


844, 


, ,*/5bP,J »,i#60 


849, 


» UHP9#P20'U 


846, 


, »«ECORQf> »/9»P|» »,l«»bid 


847, 


, LHP9#P20-U 


846, 


, lU20/9#P|t t,i»6i3 


849, 


, LH^9«P20^U 


890, 


, 20«U/9«»P,» »,lf60 


891, 


, tHP9#P20«»ll 


692, 


, «/9#P,t Sl»60 


893, 


, UHP9<»P2i'»U 


894 


, »R£CORU«»> »/9#P#» »,l»6fc5 


899 


, UHP9RP20*n 


896 


1 ULHP5#P20«n 


897 


, 11»20|* M«60 


898 


, OL.HP9#P20itll 


899 


, 20«*ll,f M»60 


660 


, OLHP9#P20»'ll 


861 


, *,» »,l»60 


862 


, OUHP9iP20»ll 


863 


, »RECORO*» »i» »,1«60 


864 


, OUHP9#P20-n 



Ut»20|» M»6t4 
20f-llf» y,lm6\6 
*,» Sl«'60 

'HECORO''^ •» » S1»6K 
11-20/P,* M-^e^ 
20-U/Pf ' M-6«s 
*/Pt* »il»60 
»RECORO«> VP# » M'-ftVJ 
U«»20/9«P, ' M-6fe> 
20«ll/9»P, • », 1-645 
• /5»P|' Sl«60 
'RECORD** «/g»P^' M-60 
ll»»20/9#P,» », 1-60 
20«ill/9l»P,» M-60 
*/9iPf» M*60 
»RECORD»> »/9#P,» M-6i!i 

ll-a0i» »,1-6W 
20-Ui» Sl»6t? 
*f» 1 1 1*60 
'RECORD-* '» ' 'il«»6k} 
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965, 

666 1 

867, 

868, 

869, 

870, 

871, 

872, 

873, 

874, 

875, 

876, 

877, 

878. 

879, 

880, 

881, 

882, 

883, 

884. 

Cr W W • 

886, 
887, 
888. 
889, 
89«, 
891, 
892. 
893, 
894, 
895. 
896, 
897, 
898, 
899, 
900. 

902. 
903, 
904, 

905, 



907, 
908. 
909, 
910, 
9U. 
912. 
913, 
914. 
915, 
916. 
917, 
918. 



11*20/P,» 1,1-685 

OLMP6l»P20»n 

20-11/p, f i,i»»6e 

OtHP5#P20»n 



*/p, 



t f 



ii>a0 



Dl.HP5#P20f»U 



'RECO«0»^ t/P,» »,1»60 
OLHP6#P20«.n 

OLHP5«P20»ll 
2«^«-ll/5»P|» »,1»60 



OLHP5#P20"»n 
*/5»P,t f,|^eiD 

DlHP5l»P20«iU 
»HeC0RD»> »/5«P| » 

OLHP5#P20i.U 
11«20/5#P, t (,l<i60 

OlHPa»P20pU 
20i'U/8*P,» »,l»60 

DIHP5#P20»U 
*/5#P| ' * I l«i0 

DlMP5#P20«»ll 
♦RECORDti> »/5#P,» 
OLMP5«»P20»ll 
S5«i820»ll 
US5«r320*'ll 
TS5«S20-.ll 
OTS5*820-11 
LS5l?S20»ll 

11*20,1 Mfi60 



t,l«60 



1««60 



•1' 



20^11,* St«60 
*»« M-'SK 
'RECORD-^ 
Ilw20/P, » 
20-ll/P, I 
*/P,» M- 
♦ReCOHO»> 



1*60 



11»20/5»8| I 
20*ll/5«8, » 



f|l«60 
»il»60 
•60 
»/P»' 



1-60 



Sl«60 

» -l»60 



*/5«S,» »,l»60 
»RECORO-> »/5«Si ' »,1*60 
U«20/5#$| > *iiiiae 
20-ll/5#S,» »,1»60 
♦ /5#S,» M«»60 
»ReCORO-> »/5#S#» t 
ULS5«»820-ll 



1«60 



1-60 
1-60 



U-20,» » 

20-11, » I 

♦f' M-60 

'RECORO»> 

ll«^20/P, » 

20-ll/P, t 

*/P#' M-60 

'Rfe"CORO-> »/P, » »,1«60 



I 



M-60 



1-60 

♦sl-60 



U-20/Pf» ',1-60 
20-ll/P,» ',l»b0 
*/Pf» •pl»60 
'RECOROi»> »/P, • Sl«b0 
11*20/5»P, « M»60 
20-U/Si:P,» »,l-60 
•/5"P,» »,l"e0 
'R£COR0«*> »/5iP,« »,l-60 
U-20/5#P,» »,1«60 
20-ll/5i»P,» M-60 
*/5#P,» ^,1«60 
'RECORD'** »/5#P,» M-60 
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919, 


1 


n-?»/9»s, ' »,l-.6« 


920, 


1 


20»11/9«S, > ',l<-60 


921, 


1 


*/5«8,» ',1*60 


922, 


» 


»ReCOR0«> »/9«5,» i|lii6id 


923, 




11<*20/9#S, ( *il«60 


924, 




20«11/9#S,( *#1«60 


925, 




•/9#3,» »,1'*60 


926, 




»«ECONO-> »/g#S,» »,l«»60 


927, 


IM85«»820-11 


926, 




11*20, t M*60 


929, 




IH89#826»*11 


930, 




20-11, » »,1»60 


931, 




LHS9M920-lt 


932, 




*,» ',1-60 


933, 




LNS5«829»11 


934, 




'HECORO»> »,» Sl-'fiKl 


939, 




UHS9«S2e<^ll 


936, 




ll»20/P,» ',1-60 


937, 




LHS9#820»11 


938, 




20*11/P,» »,1»»60 


939, 




LHS9#880«U 


940, 




*/p,» M-^ee 


941, 




UH85i»820«ll 


942. 




'«ECORO-> »/P,» »,l-60 


943, 




UHS9i«820«U 


944. 




ll«20/9«8,» M«60 


945, 




LHii9#S20*ll 


946, 




20»ll/9«S,» »,l»6V' 


947, 




LHS9<>82e*U 


946, 




*/5»S,» ',1-60 


949, 




LH89A820-U 


990, 




'RfcCQRO-> »/5»S,» ',l«60 


991, 




Lh89#S20-U 


992, 




11«20/9#S,' ',1»60 


o«« 




LHS5«»320«=11 


J- w 1 




994, 




20-11/9MS, « t,|„60 


999, 




LHS9<ipS20-ll 


996, 




•/5#S,» ',l»-60 


997, 




LNS5#820«'ll 


996, 




»RtCQRD-> »/9«»8,» »,l'»60 


999, 




UHS9II820«11 


960, 


DI.HS91IS20-U 


961, 




11-20,' ',1»60 


962, 




DLH89«320'<il 


963, 




20-iU,t t,l«60 


964, 




DLH89#820»U 


969, 




*,» »,l-60 


966, 




OLhS9i»820-U 


967, 




'RECORD-^ »,» »,l-60 


966, 




OLHS9«820p>ll 


969, 




ii-2«9/p,» si-^e^ 


970, 




Ol.MS9#820-»ll 


971, 




20-U/P,' »,l-60 


972, 




DLhS9#$20-ll 



11«20,' (,1-60 
2»»ll,» V,l»6w 

»KECORD*> ',» »,lt6«? 
11-20/P,' «,l-60 
20P11/P,' ',1-60 
•/P,» »,1«60 
»RECORD»> »/P,« »,l-60 
Il*20/Sa8,' ',1-60 
20«ll/9aS, ' ',1-6^ 
*/6»8,' »,l-60 
'RECORO'p> '/5i8, ' ',1-60 






20»^U/5#8,' »,l-60 
• /9#S,» »,1*6»«» 
'RECURO*^ »y5#S, ♦ ',1-60 

11-20,' »,l-60 
20»ll,» »,l-60 
*,» ',1*60 

»RECORO*> ',» »,i-f»^ 
U-20/P,' ',1-61^ 
20-ll/P,' «,l-6^ 
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973 


• f/P,^ M<i60 


974 


• Ot.M85#S20»ll 


975 


t 'ReC0RD*»> »/P,» f,i 


976 


• DlH89#d20-U 


977 


1 ll«20/9«S|i I,l<i60 


970 


• OLH89#820«U 


979 


1 20-ll/5»8,» t,li»6li5 


980 


1 DLH89«a20»U 


981 


, */5iS,» »#l»60 


982 


» DlH85#820pU 


983, 


1 'R&CORO»» (/9*8,t ( 


984 


» DlH89«920i-ll 


985, 


, ll<*20/9«3,t (,1«90 


986, 


> OlH89iS20pU 


987, 


1 20»ll/9#8,» l,l»60 


988, 


OLHS9t820«U 


989, 


r */5#S|< (,1»60 


99(?, 


OIHS9#S20«U 


991, 


1 «ReCORO»> f/9#8,» » 


992, 


, DLHS5#820«U 


993, 


» Ill«20 


994, 


1 Oin'p20 


995, 


, nil*20 


996, 


. OITll»20 


997, 


t 1P5»P11p20 


998, 


D1P5>PU«20 


999, 


ITP5«PUp20 


1000, 


DITP5«P11#20 


1001, 


I85*81l«»2» 


1002, 


OIS5i811-»20 


1003, 


IT85»Sll;-20 


1004, 


DITS9>$ll-f20 


1005, 


XP5#Pll»20 


1006, 


OIP5#PU«»20 


1007, 


ITP9#Plli.20 


1008, 


OITP5#PU*20 


1009, 


t89#$n»20 


1010. 


OI$S#8M»20 


10U, 


ITS9#SU"20 


10U, 


PITS9#811-20 


1013, 


I20<9ll 


1014, 


PI20»ll 


1015, 


IT20»ll 


1016, 


DIT20-11 


1017, 


IP9»P2b«11 


1018, 


OIP5«P20-ll 


1019, 


ITPS«P20-ll 


1020, 


DITP5iP20-ll 


1021, 


I$9a8204*ll 


1022, 


DIS5«3^0-ll 


1023, 


ITS5«820-ll 


1024, 


DIT35«S20'^li 


1025, 


IP5#P20i»ll 


1026, 


0IP5#P2i$-ll 



1*60 



l*60 



*/Pj» Mi»60 
»RECORD»> '/Pf' »#l-60 
lH20/5«3, ' »,l-60 
20f»U/9«Sf » Sl-S^ 
♦/5«Sf» »fl»60 
'ReCORDp> »/5«S,' M-e^ 
M-20/'5#S#» M-60 
20^U/9l>8f» M»60 
♦ /9*Sf* M»60 
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1027, ITP5<<P20-U 

IM28, 0ITP5#P2«-n 

li<)29« IS9«$2e»U 

It^^fe). Ul$54»S2i^«U 

1^931, ITS5#920«U 

1032, UITS5<f82id-U 



28.10 SELECTED EXAMPLES OF SORT PARAMETERIZATION AND 
RESULTANT OUTPUT 



This subsection gives many examples of SORT parameterization and the 
resultant output for the parameters. All of the examples in this appendix are based 
on the file XDIGT/TXT. which Is a 54 record file of primary and secondary records 
listed on the very first page following. 

Since the XDICT file is exactly 54 records long, all of its sorted output files fit 
exactly onto one page. Thus each page following the listing of the original XDICT file 
is a complete example of the sorted output file. 

The parameters for each output file are given in the heading of the page. The 
first string of characters in the heading would immediately follow the string: 

SORT INFILE:DR1,OUTRLE:DR2.:DR0; 

and the second string of characters In the heading are the LIMITED OUTPUT 
specification for the file. For example, the first example is the output of a SORT 
parameterized by the lines 31, 32, and 33 of subsection 28.9. 

The examples in this subMction were selected so that the most major 
combinations of options used by SORT are shown. Examples include super 
elementary specifications such as the first example which is a straight sort of the file 
on the l<ey in positions 11-20 and a LIMITED OUTPUT which puts out the key 
followed by the record, more Interesting combinations of options which sort the file on 
backwards descending keys and/or have a LIMITED OUTPUT which puts the key in 

♦Ko lire* rkrteitir^ne nf fho rQQQrfi Qnlv inr PRIMARY Qt RFCONDARY reCOrdS. and SOmB 

special combinations of options which show how not to use SORT as in the example 
with the heading: 

LHS5#S11-20 11-20.' M-60 

The user should understand why the above didn't seem to work right. (Hint: see 
section 28.3.9 of the SORT Section.) 

The examples selected for this subsection are in the sequence they are listed in 
subsection 28.9. Only the examples from subsection 28.9 with 'H' specified in the 
SORT COMMAND LINE were listed for this subsection (SORT did the actual 
HARDCOPY output), and only about 10% of those were selected for this subsection. 



28-34 PART III SYSTEM COMMANDS 



AGE 


I 




XDI 


CT/TXT U8E0 AS 


INPFlLE/TXTlDRi FOR SQRT 


1 


. >>> 


P 


<<< 


XHAS 


*• - PRIMARY RECORDI 


2 


, >>> 


s 


<<< 


XE8£C 


SECONDARY RECORD I 


I 


3 


, >>> 


s 


<<< 


X&NZA 


SECONDARY RECORDS 


2 


4 


. >>> 


s 


<<< 


XENON 


SECONDARY RECORDI 


3 


5 


. *>> 


s 


«< 


XERIC 


SECONDARY RECORDI 


4 


6 


, > >> 


s 


<€< 


xyuAN 


SECONDARY RECURui 


5 


7 


. >>> 


p 


*<< 


XYUEN 


• X » PRIHARY RECOKOI 


8 


• >>> 


8 


<<< 


XYIIC 


SECONDARY RECORDI 


1 


9 


. >>* 


8 


<<< 


XYLOL 


SECONDARY RECORD! 


2 


10 


a »> 


3 


<<< 


XYLENE 


SECONDARY RtCORui 


3 


U 


• >>> 


8 


<«< 


XYLOIO 


SECONDARY RECORDI 


4 


12 


9 >*> 


8 


<<< 


XYLOSE 


SECONDARY RECORDI 


5 


13 


t >>> 


P 


<<< 


XY8TER 


- <• PRIHARY RfeCURDI 


14, 


, P>> 


S 


«< 


XANTkIC 


SECONDARY RECORDI 


1 


15, 


1 >>> 


3 


<<< 


xanthin 


SECONDARY RECORDI 


2 


I6i 


1 >>> 


8 


<<< 


XIPHOIO 


SECONDARY RECORDI 


3 


17, 


1 >>> 


8 


<<< 


XYLIDIN 


SECONDARY RECORDI 


4 


18. 


f >>> 


8 


<<< 


XANTHATE 


SECONDARY RECORDI 


5 


19, 


, »> 


P 


<« 


XANTHEIN 


- X - PRIHARY RECORDI 


20, 


\ >>> 


S 


<<< 


XANTHINE 


SECONDARY RECURDI 


1 


21, 


1 >>> 


s 


<<< 


XANTHOUS 


SECONDARY RECORDI 


2 


22, 


t >» 


8 


<<< 


XEN06AHY 


SECONDARY RECORD! 


3 


23, 


t >>> 


8 


<<< 


XENOLITH 


SECONDARY RECORDI 


4 


24, 


, >>> 


8 


<<< 


XYLIOINE 


SECONDARY RECORDI 


9 


29, 


, >>> 


P 


<<< 


XYLOTOHY 


w • PRI^'ARY RECORDI 


26. 


>» 


8 


<<< 


XANTHIPPE 


SECONDARY RECORD! 


I 


27. 


>>> 


S 


<<< 


XENOGENIC 


SECONDARY RECORD! 


2 


28, 


>>> 


8 


<<< 


XEROOERKA 


SECONDARY RECORD! 


3 


29, 


>>> 


8 


<« 


XEROPHILY 


SECONDARY RECORDI 


4 


30, 


>>> 


8 


<<< 


XEHQPHYTE 


SECONDARY RECORD! 


5 


31. 


»> 


P 


<<< 


XYLOGRAPH 


• X • PRIMARY RECORD! 


32, 


>» 


8 


<<< 


XYLOPHAGE 


SECONDARY RECORD! 


I 


33, 


>>> 


8 


<<< 


XYLOPHONE 


SECONDARY RECORD! 


2 


34, 


>» 


8 


<<< 


XANTHOPHYL 


SECONDARY RECORD! 


3 


35, 


»> 


8 


<<< 


XENOGAHOUS 


SECONDARY RECORD! 


4 


36, 


>» 


8 


<« 


XENOPHOBIA 


SECONDARY RECORD! 


5 


37. 


»> 


P 


<<< 


XIPHOSURAN 


w • PRIHARY RECORD! 


38, 


»> 


8 


<<< 


XYLOGRAPHY 


SECONDARY RECORD! 


1 


39, 


>» 


8 


<<< 


XYLOTOMIST 


SECONDARY RECORD! 


2 


40, 


>>> 


8 


<« 


XYL0T0M0U8 


SECONDARY RECORD! 


3 


41. 


>» 


8 


<« 


XANTHOPHYLL 


SECONDARY RECORDI 


4 


42. 


>» 


8 


<<< 


XEN0GENE8XS 


SECONDARY RECORDI 


5 


43, 


»> 


P 


<<< 


XEN06ENBTIC 


•• X p PRIHARY RECORD! 


44. 


>» 


8 


<<< 


XENOMORPHIC 


SECONDARY RECORDI 


I 


45, 


>» 


8 


<<< 


XEWOPHILOUS 


SECONDARY RECORDI 


2 


46, 


»> 


8 


<<< 


XYLOGRAPHER 


SECONDARY RECORD! 


3 


47, 


>>> 


S 


<<< 


XYL06RAPH1C 


SECONDARY RECORDI 


4 


48. 


»> 


8 


<<< 


XYLOPHAGOUS 


SECONDARY RECORD! 


5 


49. 


>>> 


P 


<^< 


XYLOPHONIST 


- - PRIMARY RECORD! 


5b), 


»> 


8 


<<< 


XANTHOCHROIO 


SECONDARY RECORD! 


I 


51. 


»> 


8 


<<< 


XERPHTHALHIC 


SECONDARY RECORDI 


2 


52. 


>>> 


8 


<<< 


XIPHI8TERNUM 


SECONDARY RECORDI 


3 


53. 


>>> 


3 


<<< 


XEROPHTHALHIA 


SECONDARY RECORDI 


4 


54, 


»> 


8 


<<< 


XYL06RAPHICAL 


SECONDARY RECORDS 


5 



PAGE 



SORT XDICT, , ;LHll-20 



11-20, ' ' ,1-60 



X,-^ n +- t^ja +- ^s S. ^ ^ '"' 

'i' I l^ llCX L-t:: > yf ^ ^ 

xanthein >>> p 

xanthic >>> s 

xanthin >>> s 

xanthine >>> s 

Xanthippe >>> s 
xanthochro >>> s 
xanthophyl >>> s 
xanthophyi >>> s 

xanthous >>> s 

xebec >>> s 

xenia >>> s 
xenogamous >>> s 

xenogamy >>> s 
xenogenesi >>> s 
xenogeneti >>> p 

xenogenic >>> s 

xenolith >>> s 

xenomorphi >>> S 

xenon >>> s 

xenophobia >>> s 

xeric >>> s 

xeroderma >>> s 

xerophilou >>> S 

xerophily >>> S 

xerophthal >>> S 

xerophyte >>> s 

xerphthalm >>> S 

xiphistern >>> S 

xiphoid >>> s 

xiphosuran >>> p 

xma s > > > p 

xylan >>> s 

xylem >>> p 

xylene >>> s 

xylic >>> s 

xylidin / >>> s 

xylidine >>> s 

xylograph >>> p 

xylographe >>> s 

xylographi >>> s 

xylographi >>> S 

xylography >>> s 

xyloid >>> s 

xylol >>> s 

xylophage >>> s 

xylophagou >>> s 

xylophone >>> s 

xylophonis >>> p 

xylose >>> s 

xylotomist >>> s 

xylotomous >>> s 

xylotomy >>> p 

xyster >>> p 



<<< xanthate 
<<< xanthein 
<<< xanthic 
<<< xanthin 
<<< xanthine 
<<< Xanthippe 
<<< xanthochroid 
<<< xanthophyl 
<<< xanthophyll 
<<< xanthous 
<<< xebec 
<<< xenia 
<<< xenogamous 
<<< xenogamy 
<<< xenogenesis 
<<< xenogenetic 
<<< xenogenic 
<<< xenolith 
<<< xenomorphic 
<<< xenon 
<<< xenophobia 
<<< xeric 
<<< xeroderma 
<<< xerophilous 
<<< xerophily 
<<< xerophthalmia 
<<< xerophyte 
<<< xerphthalmic 
<« xiphi sternum 
<<< xiphoid 
<<< xiphosuran 
<<< xmas 
<<< xylan 
<<< xylem 
<<< xylene 
<<< xylic 
<<< xylidin 
<<< xylidine 
<<< xylograph 
<<< xylographer 
<<< xylographic 
<<< xylographical 
<<< xylography 
<<< xyloid 
<<< xylol 
<<< xylophage 
<<< xylophagous 
<<< xylophone 
<<< xylophonist 
<<< xylose 
<<< xylotomist 
<<< xylotomous 
<<< xylotomy 
<<< xyster 



SECONDARY RECORD: 5 
- X - PRIMARY RECORD 



SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD 
SECONDARY RECORD: 2 
SECONDARY RECORD: 
SECONDARY RECORD: 

SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY record: 
SECONDARY RECORD: 3 
secondary RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 

- " PRIMARY RECORD: 

- - PRIMARY RECORD: 



4 

1 

3 

5 

4 

3 

2 

4 

4 

5 

2 

3 

3 



PAGt; 



SORT XDICT, , ;LHll-20 



20-11,' ' ,1-60 



etahtnax >>> S <<< 

niehtnax >>> p <<< 

cihtnax >>> S <<< 

nihtnax >>> S <<< 

enihtnax >>> S <<< 

eppihtnax >>> S <<< 

orhcohtnax >>> S <<< 

lyhpohtnax >>> S <<< 

lyhpohtnax >>> S <<< 

suohtnax >>> S <<< 

cebex >>> S <<< 

ainex >>> S <<< 

suornagonex >>> S <<< 

ymagonex >>> S <<< 

isenegonex >>> S <<< 

itenegonex >>> P <<< 

cinegonex >>> S <<< 

htilonex >>> S <<< 

ihpromonex >>> S <<< 

nonex >>> S <<< 

aibohponex >>> S <<< 

cirex >>> S <<< 

amredorex >>> S <<< 

uolihporex >>> S <<< 

ylihporex >>> S <<< 

lahthporex >>> S <<< 

etyhporex >>> S <<< 

mlahthprex >>> S <<< 

nretsihpix >>> S <<< 

diohpix >>> S <<< 

narusohpix >>> p <<< 

samx >>> P <<< 

nalyx >>> S <« 

melyx >>> P ,<<< 

enelyx >>> S <<< 

cilyx >>> S <<< 

nidilyx >>> S <<< 

enidilyx >>> S <<< 

hpargolyx >>> P <<< 

ehpargolyx >>> S <<< 

ihpargolyx >>> S <<< 

i hpargolyx >>> S <<< 

yhpargolyx >>> S <<< 

diolyx >>> S <<< 

lolyx >>> S <<< 

egahpolyx >>> S <<< 

uogahpolyx >>> S <<< 

enohpolyx >>> S <<< 

sinohpolyx >>> P <<< 

esolyx >>> S <<< 

tsimotolyx >>> S <<< 

suomotolyx >>> S <<< 

ymotolyx >>> P <<< 

retsyx >>> P <<< 



xanthate 

xanthein 

xanthic 

xanthin 

xanthine 

Xanthippe 

xanthochroid 

xanthophyl 

xanthophyll 

xanthous 

xebec 

xenia 

xenogamous 

xenogamy 

xenogenesis 

xenogenetic 

xenogenic 

xenolith 

xenomorphic 

xenon 

xenophobia 

xeric 

xeroderma 

xerophilous 

xerophily 

xerophthalmia 

xerophyte 

xerphthalmic 

xiphi sternum 

xiphoid 

xiphosuran 

xmas 

xylan 

xylem 

xylene 

xylic 

xylidin 

xylidine 

xylograph 

xylographer 

xylographic 

xylographical 

xylography 

xyloid 

xylol 

xylophage 

xylophagous 

xylophone 

xylophonist 

xylose 

xylotomist 

xylotomous 

xylotomy 

xyster 



SECONDARY RECORD: 5 

- X - PRIMARY RECORD 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 3 

- - PRIMARY record: 

- - PRIMARY record: 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY record: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
» - PRIMARY RECORD: 

- - PRIMARY RECORD: 



PAGE 



SORT XDICT, , ;LHll-20 



' ,1-60 



2170 


>>> 


S 


<<< 


X ant hate 


SECONDARY 


record: 


5 




2211 


>>> 


P 


<<< 


xanthein 


- X - PRIMARY record: 


4 


2 10 


>>> 


S 


<<< 


xanthic 


SECONDARY 


RECORD: 


1 




2 50 


>>> 


s 


<<< 


xanthin 


SECONDARY 


record: 


2 




3 6 


>>> 


s 


<<< 


xanthine 


SECONDARY 


record: 


1 




4 6 


>>> 


s 


<<< 


Xanthippe 


SECONDARY 


record: 


1 




8 55 


>>> 


s 


<<< 


xanthochroid 


SECONDARY 


record: 


1 




5 96 


>>> 


s 


<<< 


xanthophyl 


SECONDARY 


record: 


3 




6151 


>>> 


s 


<<< 


xanthophyll 


SECONDARY 


record: 


4 




3 47 


>>> 


s 


<<< 


xanthous 


SECONDARY 


record: 


2 




42 


>>> 


s 


<<< 


xebec 


SECONDARY 


record: 


1 . 




80 


>>> 


s 


<<< 


xenia 


SECONDARY 


record: 


2 




5139 


>>> 


s 


<<< 


xenogamous 


SECONDARY 


record: 


4 




3 88 


>>> 


s 


<<< 


xenogamy 


SECONDARY 


record: 


3 




6195 


>>> 


s 


<<< 


xenogenesis 


SECONDARY 


record: 


5 




6239 


>>> 


p 


<<< 


xenogenetic 


- X - PRIMARY RECORD: 


8 


4 48 


>>> 


s 


<<< 


xenogenic 


SECONDARY 


record: 


2 




3129 


>>> 


s 


<<< 


xenolith 


SECONDARY 


record: 


4 




7 37 


>>> 


s 


<<< 


xenomorphic 


SECONDARY 


record: 


1 




0118 


>>> 


s 


<<< 


xenon 


SECONDARY 


record: 


3 




5182 


>>> 


s 


<<< 


xenophobia 


SECONDARY 


record: 


5 




0156 


>>> 


s 


<<< 


xeric 


SECONDARY 


record: 


4 




4 90 


>>> 


s 


<<< 


xeroderma 


SECONDARY 


record: 


3 




7 81 


>>> 


s 


<<< 


xerophilous 


SECONDARY 


record: 


2 




4132 


>>> 


s 


<<< 


xerophily 


SECONDARY 


record: 


4 




8190 


>>> 


s 


<<< 


xerophthalmia 


Secondary 


record: 


4 




4174 


>>> 


s 


<<< 


xerophyte 


SECONDARY 


record: 


5 




8100 


>>> 


s 


<« 


xerphthalmic 


secondary 


record: 


2 




8145 


>>> 


s 


<<< 


xiphi sternum 


SECONDARY 


record: 


3 




2 90 


>>> 


s 


<<< 


xiphoid 


SECONDARY 


record: 


3 




5225 


>>> 


p 


<<< 


xiphosuran 


- - PRIMARY record: 


7 


1 


>>> 


p 


<<< 


xmas 


- - PRIMARY record: 


1 


0194 


>>> 


s 


<<< 


xylan 


SECONDARY 


record: 


5 




0232 


>>> 


p 


<<< 


xylem 


- X - PRIMARY record: 


2 


1100 


>>> 


s 


<<< 


xylene 


SECONDARY 


record: 


3 




1 24 


>>> 


s 


<<< 


xylic 


SECONDARY 


record: 


1 




2130 


>>> 


s 


<<< 


xylidin 


secondary 


record: 


4 




3170 


>>> 


s 


<<< 


xylidine 


SECONDARY 


record: 


5 




4216 


>>> 


p 


<<< 


xylograph 


- X - PRIMARY RECORD: 


6 


7125 


>>> 


s 


<<< 


xylographer 


SECONDARY 


record: 


3 




7169 


>>> 


s 


<<< 


xylographic 


SECONDARY 


record: 


4 




8236 


>>> 


s 


<<< 


xylographical 


SECONDARY 


record: 


5 




6 22 


>>> 


s 


<<< 


xylography 


SECONDARY 


record: 


1 




1139 


>>> 


s 


<<< 


xyloid 


SECONDARY 


record: 


4 




1 62 


>>> 


s 


<<< 


xylol 


SECONDARY 


record: 


2 




5 12 


>>> 


s 


<<< 


xylophage 


SECONDARY 


record: 


1 




7213 


>>> 


s 


<<< 


xylophagous 


SECONDARY 


record: 


5 




5 54 


>>> 


s 


<<< 


xylophone 


SECONDARY 


record: 


2 




8 7 


>>> 


p 


<<< 


xylophonist 


- - PRIMARY record: 


9 


1178 


>>> 


s 


<<< 


xylose 


SECONDARY 


record: 


5 




6 65 


>>> 


s 


<<< 


xylotomist 


SECONDARY 


record: 


2 




6108 


>>> 


s 


<<< 


xylotomous 


SECONDARY 


record: 


3 




3211 


>>> 


p 


<<< 


xylotomy 


- - PRIMARY RECORD: 


5 


1217 


>>> 


p 


<<< 


xyster 


- - PRIMARY RECORD: 


2 



PAGE 



SORT XDICT,, ;LH11~20 



'RECORD-> 



rl-60 



RECORD=> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD--> 

RECORD-> 

RECORD~> 

RECORD- > 

RECORD~> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD~> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD~> 

RECORD-> 

RECORD-> 

RECORD- > 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD- > 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD -> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 

RECORD-> 



>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

> > > 

>>> 

>> > 

>>> 

>> > 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 

>>> 
>>> 

>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 



P 
S 
o 
S 
S 
S 
S 

s 

s 

s 

s 

s 

s 

s 

p 

s 

s 

s 

s 

s 

s 

s 

s 

s 

s 

s 

s 

s 

s 

p 

p 

s 

p 

s 

s 

s 

s 

p 

s 

s 

s 

s 

s 

s 

s 

s 

s 

p 

s 

s 

s 

p 

p 



<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 

<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 



X ant hate 

xanthein 

xanthic 

xanthin 

xanthine 

Xanthippe 

xanthochroid 

xanthophyl 

xanthophyll 

xanthous 

xebec 

xenia 

xenogamous 

xenogamy 

xenogenesis 

xenogenetic 

xenogenic 

xenolith 

xenomorphic 

xenon 

xenophobia 

xeric 

xeroderma 

xerophilous 

xerophily 

xerophthalmia 

xerophyte 

xerphthalmic 

xiphi sternum 

xiphoid 

xiphosuran 

xmas 

xylan 

xylem 

xylene 

xylic 

xylidin 

xylidine 

xylograph 

xylographer 

xylographic 

xylographical 

xylography 

xyloid 

xylol 

xylophage 

xylophagous 

xylophone 

xylophonist 

xylose 

xylotomist 

xylotomous 

xylotomy 

xyster 



SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 4 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY record: 4 
SECONDARY RECORD: 3 
secondary RECORD: 5 

- X - PRIMARY RECORD: 8 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 7 

- - PRIMARY RECORD: 1 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 6 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 

- - PRIMARY RECORD: 9 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
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xenogeneti 
>>> S <<< 
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xanthate 

>>> P <<< xanthein 

xanthic 

xanthin 

xanthine 

Xanthippe 

xanthochroid 

xanthophyl 

xanthophyll 

xanthous 

xebec 

xenia 

xenogamous 

xenogamy 

xenogenesis 

>>> P <<< xenogenetic 



SECONDARY RECORD: 5 

- X - PRIMARY RECORD 



SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 



>>> 
>>> 
>>> 
>>> 
>>> 
>> > 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 



S 

S 

s 
s 
s 
s 
s 
s 
s 
s 
s 
s 



<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
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>>> S <<< 

xylem 
>>> S <<< 
>>> s <<< 
>>> s <<< 
>>> s <<< 

xylograph 
>>> S <<< 
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xiphosuran 
xmas 

xylem 



xylograph 



SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
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<<< 
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<<< 
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xylophonis 
>>> S <<< 
>>> S <<< 
>>> S <<< 

xylotomy 
xyster 



xenogenic 

xenolith 

xenomorphic 

xenon 

xenophobia 

xeric 

xeroderma 

xerophilous 

xeropbily 

xerophthalmia 

xerophyte 

xerphthalmic 

>&i phi sternum 

xiphoid 

>>> P <<< 

>>> P <<< 

xylan 

>>> P <<< 
xylene 

xylic 

xylidin 

xylidine 

>>> P <« 

xylographer 

xylographic 

xylographical 

xylography 

xyloid 

xylol 

xylophage 

xylophagous 

xylophone 

>>> P <<< xylophonist 

xylose SECONDARY 

xylotomist SECONDARY 

xylotomous SECONDARY 

>>> P <<< xylotomy 

>>> P <<< xyster 



SECONDARY 

SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 

SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
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RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
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RECORD: 
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RECORD: 2 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
record: 

- - PRIMARY RECORD: 

- - PRIMARY RECORD; 
record: 5 

- X - PRIMARY RECORD: 
record: 3 

record: 1 
record: 4 
RECORD: 5 

- X - PRIMARY RECORD: 
RECORD: 3 

RECORD: 4 
RECORD: 5 
record: 1 
record: 4 
record: 2 
record: 1 
record: 5 
record: 2 

- - PRIMARY record: 
record: 5 

record: 2 
record: 3 

- ~ PRIMARY record: 

- - PRIMARY record: 
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<<< 
<<< 
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<<< 
<<< 
<<< 
<<< 



6239 >>> 
>>> S <<< 

s 



>>> S <<< xanthate 

2211 >>> p <<< xanthein 
S <<< xanthic 
xanthin 
xanthine 
Xanthippe 
xanthochroid 
xanthophyl 
xanthophyll 
xanthous 
xebec 
xenia 

xenogamous 
xenogamy 
xenogenesis 

P <<< xenogenetic 
xenogenic 
xenolith 
xenomorphic 
xenon 

xenophobia 
xeric 
xeroderma 
xerophilous 
:icrophily 
xerophthalmia 
xerophyte 
xerphthalmic 
xiphi sternum 
xiphoid 
5225 >>> p <<< xiphosuran 
1 >>> p\ <<< xmas 
>>> S <<< xylan 

0232 >>> p <<< xylem 
>>> S <<< xylene 
>>> s <<< xylic 
>>> S <<< xylidin 
>>> S <<< xylidine 

4216 >>> p <<< xylograph 
>>> S <<< xylographer 
<<< xylographic 
<<< xylographical 
<<< xylography 
<<< xyloid 
<<< xylol 
<<< xylophage 
<<< xylophagous 
<<< xylophone 
7 >>> p <<< xylophonist 
S <<< xylose 
S <<< xylotomist 
S <<< xylotomous 

P <<< xylotomy 
P <<< xyster 
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SECONDARY RECORD: 5 

- X - PRIMARY RECORD 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY record: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 

- - PRIMARY record: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 

- - PRIMARY record: 

- - PRIMARY record: 
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>>> S 
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>>> 
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>>> S 
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>>> S 

>>> s 
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>>> S 
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>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
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<<< X ant hate 

> >>> P <<< xanthein 

<<< xanthic 

<<< xanthin 

<<< xanthine 

<<< Xanthippe 

<<< xanthochroid 

xanthophyl 

xanthophyll 
<<< xanthous 
<<< xebec 
<<< xenia 

xenogamous 

xenogamy 
<<< xenogenesis 
-> >>> P <<< xenogenetic 
<<< xenogenic 
<<< xenolith 
<<< xenomorphic 
<<< xenon 
<<< xenophobia 
<<< xeric 
<<< xeroderma 
<<< xerophilous 
<<< xerophily 
<<< xerophthalmia 
<<< xerophyte 
<<< xerphthalmic 
<<< xiphisternum 
<<< xiphoid 

-> >>> p <<< xiphosuran 
•> >>> P <<< xmas 
<<< xylan 

■> >>> P <<< xylem 
<<< xylene 
<<< xylic 
<<< xylidin 
<<< xylidine 
■> >>> P <« xylograph 
<<< xylographer 
<<< xylographic 
<<< xylographical 
<<< xylography 
<<< xyloid 
<<< xylol 
<<< xylophage 
<<< xylophagous 
<<< xylophone 

> >>> P <« xylophonist 
<<< xylose 
<<< xylotomist 
<<< xylotomous 

> >>> P <<< xylotomy 

> >>> P <<< xyster 



SECONDARY RECORD: 5 

- X - PRIMARY RECORD 
record: 1 
RECORD: 
record: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
RECORD: 
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RECORD: 
record: 
record: 
RECORD: 
record: 
record: 
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record: 
record: 
record: 
record: 
record: 

- C - PRIMARY record: 

• - PRIMARY RECORD; 
record: 5 

• X - PRIMARY RECORD: 
record: 3 
record: 1 
RECORD: 4 
record: 5 

■ X - PRIMARY record: 
record: 3 
record: 4 
record: 5 
record: 1 
RECORD: 4 
RECORD: 2 
record: 1 
RECORD: 5 
record: 2 

■ - PRIMARY record: 
record: 5 
record: 2 
RECORD: 3 

- - PRIMARY record: 

- - PRIMARY record: 
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SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
SECONDARY 
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xanthate 
>>> P <<< 

xanthic 

xanthin 

xanthine 
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xanthochro 

xanthophyl 

xanthophyl 

xanthous 

xebec 
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xenogainous 
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xenogenic 
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>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 
>>> 



xiphoid 
>>> P <<< 
>>> P <<< 

xylan 
>>> P <<< 

xylene 
xylic 
xylidin 
xylidine 

>>> P <<< 
xylographe 
xylographi 
xylographi 
xylography 
xyloid 
xylol 
xylophage 
xylophagou 
xylophone 

>>> P <<< 
xylose 
xylotomist 
xylotomous 

>>> P <<< 

>>> P <<< 
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xenogenic 

xenolith 

xenomorphic 

xenon 

xenophobia 

xeric 

xeroderma 

xerophilous 

xerophily 

xerophthalmia 
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xylophage 
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xylophone 



<<< 
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>>> S <<< xylose 
>>> S <<< xylotomist 
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SECONDARY RECORD: 1 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 2 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 4 

SECONDARY RECORD: 3 

SECONDARY RECORD: 5 
PRIMARY RECORD: 8 

SECONDARY RECORD: 2 

SECONDARY RECORD: 4 

SECONDARY RECORD: 1 

SECONDARY RECORD: 3 

SECONDARY RECORD: 5 
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SECONDARY RECORD: 3 
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SECONDARY RECORD: 5 

secondary record: 1 

SECONDARY RECORD: 4 
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etahtnax 
>>> P <<< 

cihtnax 

nihtnax 

enihtnax 

eppihtnax 

orhcohtnax 

lyhpohtnax 

lyhpohtnax 

suohtnax 

cebGx 

ainex 

suomagonex 

ymagonex 

isenegonex 

>>> P <<< 

cinegonex 

htilonex 

ihpromonex 

nonex 

aibohponex 

cirex 

amredorex 

uolihporex 

ylihporex 

lahthporex 

etyhporex 

mlahthprex 

nretsihpix 

diohpix 

>>> P <<< 

>>> P <<< 

nalyx 
>>> P <<< 

enelyx 

cilyx 

nidilyx 

enidilyx 

>>> P <<< 

ehpargolyx 

ihpargolyx 

ihpargolyx 

yhpargolyx 

diolyx 

lolyx 

eg a hpo 1 yx 

uogahpolyx 

enohpolyx 

>>> P <<< 
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>>> P <<< 
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xanthic 
xanthin 
xanthine 
Xanthippe 
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<<<i xanthochroid 
xanthophyl 
xanthophyll 
xanthous 
xebec 
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xenogamous 
xenogamy 
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<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
<<< 
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xenogenetic 
>>> S <<< xenogenic 
>>> S <<< xenolith 
>>> S <<< xenomorphic 
>>> S <<< xenon 
>>> S <<< xenophobia 
>>> s <<< xeric 
>>> S <<< xeroderma 
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SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY record: 

1 
2 
3 
4 
5 



secondary record: 
secondary record: 
secondary record: 
secondary record: 
secondary record: 

- - PRIMARY record: 
secondary record: 1 
secondary record: 2 
SECONDARY RECORD: 3 
secondary record: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 



SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
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>>> P <<< 

xanthein 
xanthein 
xanthein 
xanthein 
xanthein 
>>> P <<< 



xanthein 
>>> S <<< 
>>> S <<< 
»> s <<< 
>>> s <<< 
>>> s <<< 



xenogenetic 



xanthine 
xanthous 
xenogamy 
xenolith 
xylidine 



xenogeneti >>> S <<< 
xenogeneti >>> s <<< 
xenogeneti >>> S <<< 
xenogeneti >>> S <<< 
xenogeneti >>> s <<< 
>>> p <<< xiphosuran 



xiphosuran 

xiphosuran 

xiphosuran 

xiphosuran 

xiphosuran 

>>> p <<< 

xmas 

xmas 

xmas 

xmas 

xmas 

>>> p <<< 

xylem 

xylem 

xylem 

xylem 

xylem 

>>> p <<< 

xylograph 

xylograph 

xylograph 

xylograph 

xylograph 

>>> p <<< 

xylophonis 
xylophonis 
xylophonis 
xylophonis 
xylophonis 
>>> p <<< 

xylotomy 

xylotomy 

xylotomy 

xylotomy 

xylotomy 

>>> p <<< 

xyster 

xyster 

xyster 

xyster 

xyster 
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>>> 

>>> 

>>> 

>>> 
xmas 

>>> 

>>> 

>>> 

>>> 

>>> 
xylem 

>>> S 

>>> S 

>>> s 
>>> s 
>>> s 



s 
s 
s 
s 
s 

s 
s 
s 
s 
s 



<<< 
<<< 
<<< 
<<< 
<<< 

<<< 
<<< 
<<< 
<<< 
<<< 

<<< 
<<< 
<<< 
<<< 
<<< 



xylograph 
>>> s <<< 



>>> 
>>> 
>>> 
>>> 



s 
s 
s 
s 



<<< 
<<< 
<<< 
<<< 



xylophonist 



xenomorphic 
xerophilous 
xylographer 
xylographic 
xylophagous 



xylography 

xylotomist 

xylotomous 

xanthophyll 

xenogenesis 



xebec 
xenia 
xenon 
xeric 
xylan 

xylic 

xylol 

xylene 

xyloid 

xylose 

xylophage 

xylophone 

xanthophyl 

xenogamous 

xenophobia 
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>>> 
>>> 

>>> 
>>> 



S 

s 
s 
s 
s 



<<< 
<<< 
<<< 
<<< 
<<< 



xylotomy 
>>> S <<< 

s 



s 
s 
s 



>>> 
>>> 
>>> 
>>> 

xyster 
>>> S 

>>> s 

>>> s 

>>> s 

>>> s 



<<< 
<<< 
<<< 
<<< 

<<< 
<<< 
<<< 
<<< 
<<< 



xanthochroid 
xerphthalmic 
xiphi sternum 
xerophthalmia 
xylographical 
- 
Xanthippe 
xenogenic 
xeroderma 
xerophily 
xerophyte 



xanthic 
xanthin 
xiphoid 
xylidin 
xanthate 



- X - PRIMARY record: 4 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- X - PRIMARY record: 8 
SECONDARY RECORD: 1 
secondary record: 2 
SECONDARY RECORD: 3 
secondary record: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 7 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

~ X - PRIMARY RECORD: 2 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 6 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY record: 9 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

PRIMARY RECORD: 5 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- - PRIMARY record: 3 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 
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>>> P <<< xanthein 



2211 
2211 
2211 
2211 
2211 



>>> 
>>> 

>>> 
>>> 
>>> 



<<< 

<<< 
<<< 
<<< 
<<< 



>>> P <<< 



xanthine 
xanthous 
xenogamy 
xenolith 
xylidine 



6239 
6239 
6239 
6239 
6239 



xenogenetic 



>>> 
>>> 
>>> 
>>> 
>>> 



<<< 
<<< 
<<< 
<<< 
<<< 



>>> P <<< xiphosuran 



xenomorphic 
xerophilous 
xylographer 
xylographic 
xylophagous 



b225 
5225 
5225 
5225 
5225 

>>> p 






>>> p 



>>> 
>>> 
>>> 
>>> 
>>> 



<<< 
<<< 
<<< 
<<< 
<<< 



< < < xma s 
1 >>> S <<< 

1 >>> s 



>>> 
>>> 
>>> 

>>> 



<<< 
<<< 
<<< 
<<< 



0232 
0232 
0232 
0232 
0232 



<<< xylem 
>>> S <<< 

s 



>>> 
>>> 
>>> 
>>> 



<<< 
<<< 
<<< 
<<< 



>>> p <<< 



4216 
4216 
4216 
4216 
4216 
>>> p 
8 



xylograph 



xylography 

xylotomist 

xylotomous 

xanthophyll 

xenogenesls 

xebec 
xenia 
xenon 
xeric 
xylan 

xylic 

xylol 

xylene 

xyloid 

xylose 



>>> 
>>> 
>>> 
>>> 
>>> 



s 
s 
s 
s 
s 



<<< 
<<< 
<<< 
<<< 
<<< 



xylophage 

xylophone 

xanthophyl 

xenogamous 

xenophobia 



<<< xylophonist 

7 >>> s <<< xanthochroid 



>>> 
>>> 
>>> 
>>> 



<<< 
<<< 
<<< 
<<< 



>>> P <<< xylotomy 
3211 >>> s <<< 
3211 >>> S <<< 
3211 >>> S <<< 
3211 >>> S <<< 
3211 >>> S <<< 

>>> P <<< xyster 
1217 >>> S <<< 
1217 >>> S <<< 
1217 >>> S <<< 
1217 >>> S <<< 
1217 >>> S <<< 



xerphthalmic 
xiphi sternum 
xerophthalmia 
xylographical 

r 

Xanthippe 
xenogenic 
xeroderma 
xerophily 
xerophyte 

xanthic 
xanthin 
xiphoid 
xylidin 
xanthate 



- X - PRIMARY record: 4 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- X - PRIMARY record: 8 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- - PRIMARY RECORD: 7 

SECONDARY RECORD* 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- - PRIMARY record: 1 

SECONDARY RECORD: 1 

SECONDARY RECORD: 2 

SECONDARY RECORD: 3 

SECONDARY RECORD: 4 

SECONDARY RECORD: 5 

- X - PRIMARY record: 2 

SECONDARY RECORD: 1 

secondary record: 2 

SECONDARY RECORD: 3 

secondary record: 4 

SECONDARY RECORD: 5 

- X - PRIMARY record: 6 

SECONDARY RECORD: 1 

secondary record: 2 

SECONDARY RECORD: 3 

secondary record: 4 

SECONDARY RECORD: 5 

- - PRIMARY RECORD: 9 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY record: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
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xyster 


>>> 


' P 


xanthic 


>>> 


S 


xanthin 


>>> 


■ s 


xiphoid 


>>> 


s 


xylidm 


>>> 


s 


X ant hate 


>>> 


s 


xylotomy 


>>> 


p 


Xanthippe 


>>> 


s 


xenogerjif; 


>>> 


s 


xeroderrfi.j 


>>> 


s 


xerophil y 


> > > 


s 


xerophyte 


>>> 


s 


xylophonis 


^ > > 


p 


xanthochro 


>>> 


s 


xerphthalm 


>>> 


s 


xiphi stern 


>>> 


s 


xerophthal 


>> > 


s 


xylographi 


>>> 


s 


xylograph 


>>> 


p 


xylophage 


>>> 


s 


xylophone 


>>> 


s 


xanthophyl 


>>> 


s 


xenogamous 


>>> 


s 


xenophobia 


>>> 


s 


xylem 


>>> 


p 


xylic 


>>> 


s 


xylol 


>>> 


s 


xylene 


>>> 


s 


xyloid 


>>> 


s 


xylose 


>>> 


s 


xmas 


>>> 


p 


xebec 


>>> 


s 


xenia 


>>> 


s 


xenon 


>>> 


s 


xeric 


>>> 


s 


xylan 


>>> 


s 


xiphosuran 


>>> 


p 


xylography 


>>> 


s 


xylotomist 


>>> 


s 


xylotomous 


>>> 


s 


xanthophyl 


>>> 


s 


xenogenesi 


>>> 


s 


xenogeneti 


>>> 


p 


xenomorphi 


>>> 


s 


xerophilou 


>>> 


s 


xylographe 


>>> 


s 


xylographi 


>>> 


s 


xylophagou 


>>> 


s 


xanthein 


>>> 


p 


xanthine 


>>> 


s 


xanthous 


>>> 


s 


xenogamy 


>>> 


s 


xenolith 


>>> 


s 


xylidine 


>>> 


s 



<<< xyster 
<<< xanthic 
<<< xanthin 
<<< xiphoid 
<<< xylidin 
<<< xanthate 
<<< xylotomy 
<<< Xanthippe 
<<< xenogenic 
<<< xeroderma 
<<< xerophily 
<<< xerophyte 
<<< xylophonist 
<<< xanthochroid 
<<< xerphthalmic 
<<< xiphisternum 
<« xerophthalmia 
<<< xylographical 
<<< xylograph 
<<< xylophage 
<<< xylophone 
<<< xanthophyl 
<<< xenogamous 
<<< xenophobia 
<<< xylem 
<<< xylic 
<<< xylol 
<<< xylene 
<<< xyloid 
<<< xylose 
<<< xmas 
<<< xebec 
<<< xenia 
<<< xenon 
<<< xeric 
<<< xylan 
<<< xiphosuran 
<<< xylography 
<<< xylotomist 
<<< xylotomous 
<<< xanthophyll 
<<< xenogenesis 
<<< xenogenetic 
<<< xenomorphic 
<<< xerophilous 
<<< xylographer 
<<< xylographic 
<<< xylophagous 
<<< xanthein 
<<< xanthine 
<<< xanthous 
<<< xenogamy 
<<< xenolith 
<<< xylidine 



- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 



SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY record: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
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xmas 


>>> 


P 


<<< 


xmas 


xebec 


>>> 


S 


<<< 


xebec 


xenia 


>>> 


S 


<<< 


xenia 


xenon 


>>> 


s 


<<< 


xenon 


xeric 


>>> 


s 


<<< 


xeric 


xylan 


>>> 


s 


<<< 


xylan 


xylem 


>>> 
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<<< 


xylem 


xylene 


>>> 
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<<< 


xylene 


xylic 


>>> 


s 


<<< 


xylic 


xyloid 


>>> 


s 


<<< 


xyloid 


xylol 


>>> 


s 


<<< 


xylol 


xylose 


>>> 
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<<< 


xylose 


xyster 


>>> 
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<<< 


xyster 


xanthate 


>>> 


s 


<<< 


xanthate 


xanthic 


>>> 


s 


<<< 


xanthic 


xanthin 


>>> 


s 


<<< 


xanthin 


xiphoid 


>>> 


s 


<<< 


xiphoid 


xylidin 


>>> 


s 


<<< 


xylidin 


xanthein 


>>> 


p 


<<< 


xanthein 


xanthine 


>>> 


s 


<<< 


xanthine 


xanthous 


>>> 


s 


<<< 


xanthous 


xenogamy 


>>> 


s 


<<< 


xenogamy 


xenolith 


>>> 


s 


<<< 


xenolith 


xylidine 


>>> 


s 


<<< 


xylidine 


xylotomy 


>>> 


p 


<<< 


xylotomy 


Xanthippe 


>>> 


s 


<<< 


Xanthippe 


xenogenic 


>>> 


s 


<<< 


xenogenic 


xeroderma 


>>> 


s 


<<< 


xeroderma 


xerophily 


>>> 


s 


<<< 


xerophily 


xerophyte 


>>> 


s 


<<< 


xerophyte 


xylograph 


>>> 


p 


<<< 


xylograph 


xanthophyl 


>>> 


s 


<<< 


xanthophyl 


xenogamous 


>>> 


s 


<<< 


xenogamous 


xenophobia 


>>> 


s 


<<< 


jcenophobia 


xylophage 


>>> 


s 


<<< 


xylophage 


xylophone 


>>> 


s 


<<< 


xylophone 


xiphosuran 


>>> 
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<<< 


xiphosuran 


xanthophyl 


>>> 


s 


<<< 


xanthophyll 


xenogenesi 


>>> 


s 


<<< 


xenogenesis 


xylography 


>>> 


s 


<<< 


xylography 


xylotomist 


>>> 


s 


<<< 


xylotomist 


xylotomous 


>>> 
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<<< 


xylotomous 


xenogeneti 


>>> 
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<<< 


xenogenetic 


xenomorphi 


>>> 
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<<< 


xenomorphic 


xerophilou 


>>> 
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<<< 


xerophilous 


xylographe 


>>> 
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<<< 


xylographer 


xylographi 


>>> 
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<<< 


xylographic 


xylophagou 


>>> 


s 


<<< 


xylophagous 


xylophonis 


>>> 


p 


<<< 


xylophonist 


xanthochro 


>>> 


s 


<<< 


xanthochro id 


xerophthal 


>>> 
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<<< 


xerophthalmia 


xerphthalm 


>>> 


s 


<<< 


xerphthalmic 


xiphistern 


>>> 
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<<< 


xiphi sternum 


xylographi 


>>> 


s 


<<< 


xylographical 



- - PRIMARY record: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 
SECONDARY RECORD: 5 

- - PRIMARY record: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- ~ PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 

- - PRIMARY RECORD: 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 

- X - PRIMARY record: 
SECONDARY RECORD: 1 
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SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
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SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 
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xyiophonis >>> p <<< 
xylograph! >>> s <<< 
xiphistern >>> S <<< 
xerrphthdlm >>> S <<< 
xerophthai >>> S <<< 
xanthochro >>> S <<< 
xc^nogeneti >>> p <<< 
xylophagou >>> s <<< 
xylograph! >>> S <<< 
xylographe >>> s <<< 
xerophllou >>> S <<< 
xenomorphi >>> S <<< 
xiphosuran >>> P <<< 
xylotomous >>> S <<< 
xylotomist >>> s <<< 
xylography >>> s <<< 
xenogenesi >>> S <<< 
xanthophyl >>> S <<< 
xylograph >>> p <<< 
xylophone >>> s <<< 
xylophage >>> s <<< 
5ienophobia >>> S <<< 
xenogamous >>> s <<< 
xanthophyl >>> S <<< 
xylotorny >>> p <<< 
xerophyte >>> s <<< 
xerophily >>> s <<< 
xeroderma >>> S <<< 
xenogenic >>> s <<< 
Xanthippe >>> s <<< 
xanthein >>> p <<< 
xylidine >>> s <<< 
xenolith >>> s <<< 
xenogamy >>> s <<< 
xanthous >>> s <<< 
xanthine >>> s <<< 
xyster >>> p <<< 
xylidin >>> s <<< 
xiphoid >>> s <<< 
xanthin >>> s <<< 
xanthic >>> s <<< 
xanthate >>> S <<< 
xylem >>> p <<< 
xylose >>> s <<< 
xylol >>> s <<< 
xyloid >>> s <<< 
xylic >>> s <<< 
xylene >>> s <<< 
xmas >>> p <<< 
xylan >>> s <<< 
xeric >>> s <<< 
xenon >>> s <<< 
xenia >>> s <<< 
xebec >>> s <<< 



xylophonist 

xylographical 

xiphi sternum 

xerphthalmic 

xerophthalmia 

xanthochroid 

xenogenetic 

xylophagous 

xylographic 

xylographer 

xerophilous 

xenomorphic 

xiphosuran 

xylotomous 

xylotomist 

xylography 

xenogenesis 

xanthophyll 

xylograph 

xylophone 

xylophage 

xenophobia 

xenogamous 

xanthophyl 

xylotorny 

xerophyte 

xerophily 

xeroderma 

xenogenic 

Xanthippe 

xanthein 

xylidine 

xenolith 

xenogamy 

xanthous 

xanthine 

xyster 

xylidin 

xiphoid 

xanthin 

xanthic 

xanthate 

xylem 

xylose 

xylol 

xyloid 

xylic 

xylene 

xmas 

xylan 

xeric 

xenon 

xenia 

xebec 



- - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD; 
SECONDARY RECORD: 5 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 4 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
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xanthate >>> 
xanthein >>> 
xanthic >>> 
xanthin >>> 
xanthine >>> 
Xanthippe >>> 
xanthochro >>> 
xanthophyl >>> 
xan thophyl >>> 
xanthous >>> 
xebec >>> 
xenia >>> 
xenogamous >>> 
xenogamy >>> 
xenogenesi >>> 
xenogeneti >>> 
xenogenic >>> 
xenolith >>> 
xenomorphi >>> 
xenon >>> 
xenophobia >>> 
xiphosiirari >>> 
xeric >>> 
xeroderma >>> 
xerophilou >>> 
xerophily >>> 
xerophthal >>> 
xerophyte >>> 
xylograph >>> 
xerphthalm >>> 
xiphistern >>> 
xiphoid >>> 
xylan >>> 
xylem >>> 
xylene >>> 
xylic >>> 
xylidin >>> 
xylidine >>> 
xylotomy >>> 
xylographe >>> 
xylographi >>> 
xylographi >>> 
xylography >>> 
xyloid >>> 
xylol >>> 
xylophage >>> 
xylophagou >>> 
xylophonis >>> 
xylophone >>> 
xylose >>> 
xyster >>> 
xylotomist >>> 
xylotomous >>> 
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xanthate 

xanthein 

xanthic 

xanthin 

xanthine 

Xanthippe 

xanthochro id 

xanthophyl 

xanthophyll 

xanthous 

xebec 

xenia 

xenogamous 

xenogamy 

xenogenesis 

xenogenetic 

xenogenic 

xenolith 

xenomorphic 

xenon 

xenophobia 

xiphosuran 

xeric 

xeroderma 

xerophilous 

xerophily 

xerophthalmia 

xerophyte 

xylograph 

xerphthalmic 

xiphi sternum 

xiphoid 

xylan 

xylem 

xylene 

xylic 

xylidin 

xylidine 

xylotomy 

xylographer 

xylographic 

xylographical 

xylography 

xyloid 

xylol 

xylophage 

xylophagous 

xylophonist 

xylophone 

xylose 

xyster 

xylotomist 

xylotomous 



SECONDARY RECORD: 5 
- X - PRIMARY RECORD 
SECONDARY RECORD: 1 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY record: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 
SECONDARY record: 
SECONDARY RECORD: 
secondary RECORD: 

- - PRIMARY record: 
SECONDARY RECORD: 4 
secondary record: 
SECONDARY RECORD: 
secondary RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 

- X - PRIMARY record: 
SECONDARY RECORD: 3 
secondary record: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 

- ~ PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY record: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 5 

- - PRIMARY record: 
SECONDARY RECORD: 2 
secondary record: 3 
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xmas 

xmas 

xylan 

xylem 

xylose 

xyster 

xanthate 

xanthein 

xylidine 

xylotomy 

xerophyte 

xylograph 

xenophobia 

xiphosuran 

xenogenesis 

xenogenetic 

xylophagous 

xylophonist 



- - PRIMARY RECORD: 1 

- - PRIMARY RECORD: 1 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 2 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 3 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 4 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 5 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 6 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 7 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 8 
SECONDARY RECORD: 5 

- - PRIMARY RECORD: 9 
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xyster 
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xylograph 
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xylograph 


xerophily 
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xenophobia 
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xylographe 
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xylographi 
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xylographi 
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xenogenesi 
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- - PRIMARY record: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 

- X - PRIMARY record: 
SECONDARY RECORD: 5 
secondary record: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY RECORD: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 



- X - PRIMARY RECORD: 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 5 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 2 

- - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 

- O - PRIMARY RECORD: 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 2 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
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xylography >>> s 
xerophilou >>> S 
xylophagou >>> s 
xylotomi^t >>> s 
xylotomous >>> s 
xenogarnous >>> s 
xylpphonis >>> p 
xanthochro >>> S 
xiphistern >>> S 
xiphosuran >>> p 
xerphthalm >>> s 
xanthophyl >>> s 
xanthophyl >>> S 
xerophthal >>> S 
xenogeneti >>> p 
xenogenesi >>> s 
xenomorphi >>> S 
xylograph! >>> s 
xylographi >>> S 
xylographe >>> s 
xenophobia >>> s 
xerophily >>> s 
xylograph >>> p 
xerophyte >>> S 
Xanthippe >>> s 
xylophone >>> s 
xylophage >>> s 
xenogenic >>> s 
xeroderma >>> s 
xylotomy >>> p 
xenogamy >>> s 
xanthous >>> s 
xanthein >>> p 
xenolith >>> S 
xanthate >>> s 
xanthine >>> s 
xylidine >>> s 
xanthin >>> s 
xylidin >>> s 
xiphoid >>> s 
xanthic >>> s 
xyster >>> p 
xylose >>> s 
xylene >>> s 
xyloid >>> s 
xenon >>> s 
xylan >>> s 
xylem >>> p 
xylol >>> s 
xeric >>> s 
xylic >>> s 
xebec >>> s 
xenia >>> s 
xmas >>> p 



<<< xylography 
<<< xerophilous 
<<< xylophagous 
<<< xylotomist 
<<< xylotomous 
<<< xenogarnous 
<<< xylophonist 
<<< xanthochro id 
<<< xiphisternum 
<<< xiphosuran 
<<< xerphthalmic 
<<< xanthophyl 
<<< xanthophyll 
<<< xerophthalmia 
<<< xenogenetic 
<<< xenogenesis 
<<< xenomorphic 
<<< xylographic 
<« xylographical 
<<< xylographer 
<<< xenophobia 
<<< xerophily 
<<< xylograph 
<<< xerophyte 
<<< Xanthippe 
<<< xylophone 
<<< xylophage 
<<< xenogenic 
<<< xeroderma 

<<< xylotomy 
<<< xenogamy 

<<< xanthous 

<<< xanthein 

<<< xenolith 

<« xanthate 

<<< xanthine 

<<< xylidine 

<<< xanthin 

<<< xylidin 

<<< xiphoid 

<<< xanthic 

<<< xyster 

<<< xylose 

<<< xylene 

<<< xyloid 

<<< xenon 

<<< xylan 

<<< xylem 

<<< xylol 

<<< xeric 

<<< xylic 

<<< xebec 

<<< xenia 

<<< xmas 



SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 

- - PRIMARY record: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 4 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 
SECONDARY RECORD: 4 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 

- - PRIMARY RECORD: 
SECONDARY RECORD: 3 
SECONDARY RECORD: 2 

- X - PRIMARY RECORD: 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
SECONDARY RECORD: 1 
SECONDARY RECORD: 5 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 1 

- - PRIMARY RECORD: 
SECONDARY RECORD: 5 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 3 
SECONDARY RECORD: 5 

- X - PRIMARY record: 
SECONDARY RECORD: 2 
SECONDARY RECORD: 4 
SECONDARY RECORD: 1 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 

- - PRIMARY RECORD: 
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xanthate 


>>> 


s 


<<< 
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xanthein 


>>> 
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xanthein 


xanthine 


>>> 
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xanthine 



- - PRIMARY record: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 2 
SECONDARY RECORD: 3 
SECONDARY RECORD: 4 
SECONDARY RECORD: 5 
- X - PRIMARY RECORD: 



SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- - PRIMARY record: 
SECONDARY RECORD: 1 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 
SECONDARY RECORD: 

- X - PRIMARY record: 
SECONDARY R EC 0.^.0: I 
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SUR - Subdirectory command 29.0 Purpose 

When a specific disk is used for more than one purpose, some inconveniences 
occasionally turn up. Assume for a moment that a user has a disk which he is using for 
program generation on each of two more or less unrelated projects. When he uses the CAT 
command, for instance, he will normally see a whole range of files, some of which are not 
related to the project he may be currently interested in. Or, he may begin editing a new file 
on the disk, only to find that another user of the same disk may have already had a file of 
that name. At times like this, it would be convenient to logically partition the directory so that 
a user would only have a portion of it, the portion he is currently interested in, available to 
him at one time. 

A more concrete example is the DOS itself and its various commands. Obviously 
Datapoint's DOS.A, DOS.B, and DOS.C bear a strong resemblance to each other. The DOS 
and most of the command files are configured at assembly time through conditional assembly 
and equates to support a given disk controller and specific file structure. The result is several 
different object code files, all with a /ABS extension, for each single source file with a /TXT 
extension. Yet it is desirable for a numt>er of reasons to keep all of the object code files for 
all the DOS and commands on a single drive. 

Without the DOS subdirectory facility, it is not permitted to have two files on a ig^gtt 
logical drive with the same name. 

29.1 About Subdiroctorios 

The use of the SUR (Subdirectory Utility Routine) command allows the user to ki^ififtily 
partition the directory on a given disk into several smaller subdirectories. Each such 
subdirectory can then contain zero or more files, up to the maximum number of 256 fffift^ ^er 
logical drive. Each sulxjirectory on a disk has a unique name. Two subdirectories always 
exist on all drives; these are called SYSTEM and MAIN. The names for the other 
subdirectories are assigned by the user as he establishes them, and follow the same rules as 
for any standard DOS file name. As a subdirectory is created, the name specified by the user 
is related to a unique number which Is referred to as the subdirectory number. The relationship 
between subdirectory names and subdirectory numbers Is not unlike the relationship between 
DOS file names and physical file numbers. A given subdirectory may have different numbers 
on different drives, even though the subdirectory name is the same. 

It is important to realize that subdirectories are not a way of getting more than 256 files 
on a drive. This they cannot do. The thing that subdirectories are good for is partitioning the 
directory and restricting the scope of a file name. This allows several files of the same name 
to exist on one disk at the same time, without causing the DOS to become confused as to 
which is the one to be referenced at any time. The way the DOS achieves this is that each 
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of the files is in a 'different subdirectory' from each otfier, and hence is uniquely identified 
even though the name and extension may be identicf I. 

29.2J Creation of Subdirectories 

Subdirectories are created with the SUR commtind. All that is required is to specify a 
name for the proposed subdirectory and request its creation. Creation of a subdirectory does 
not actually result in any real change to the directory on disk at all; all it does is to cause 
the specified name to be entered into a table, kept on disk, which relates each subdirectory 
name with its subdirectory number. The user is allowed to specify which drive he wishes to 
create the subdirectory on; if he does not indicate a specific drive, the named subdirectory 
IS placed onto all on-line drives if possible. 

29.2.2 Deletion of Subdirectories 

Subdirectories are deleted with the SUR command. The user specifies the name of the 
subdirectory he wishes to remove and requests its deletion. Deletion of a subdirectory does 
not result in KILLing the files within the range of that subdirectory. If a subdirectory to be 
deleted contains one or more files, the files are first moved from that subdirectory to the one 
called MAIN before the named subdirectory is deleted. The user is allowed to specify from 
which drives the subdirectory is to be deleted; if he does not indicate a specific drive, the 
named subdirectory is deleted from all on-line drives on which it appears. 

29.2.3 Being 'in a Subdirectory' 

The user can define at any time which of the subdirectories on each of his disks contain 
the current files he is interested in. This is done with the SUR command by specifying the 
name of the subdirectory containing the files of current interest. This action causes him to be 
placed 'into' the named subdirectory on the drive specified. (If no specific drive is mentioned, 
he will be placed 'into' the subdirectory specified on all on-line drives containing a 
subdirectory with the given name). It is appropriate to point out that the current subdirectory 
on each drive need not have the same name; for example, the user could easily be in 
subdirectory PROGRAMS on drive zero and in subdirectory DATABASE on drive one at the 
same time. 

Once in a specific subdirectory on a drive, that state does not normally change until the 
user requests being placed into a different subdirectory (again via the SUR command) or 
re-boots the DOS. Rebooting the DOS causes the user to be placed into the subdirectory 
named SYSTEM on all drives. 

29.2.4 Scope of a File Name 

When a program accesses a file under DOS, it tells DOS the name and extension of the 
file it is looking for and either indicates one specific drive which the DOS is to search for the 
file, or requests that the DOS look on all on-line drives. In order for the DOS to 'find' the 
given file, the DOS must find a file whose name and extension exactly match the ones 
specified by the requesting program. If no such file can be found, the DOS returns indicating 
that the specified file cannot be found and therefore probably does not exist. 
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When subdirectories are in use, this matching of name and extension is expanded so 
that in addition to a file's name and extension matching those specified by the requesting 

^'Tr^J^^ ^"^ """"'^ ^"'^ ^^ ^'*^'" ^**^^^ ^^^ ""^''^^^ subdirectory (for that drive) or the one 
called SYSTEM in order to be 'found'. 

Therefore the scope of a file name can be more or less defined via the following- 
when a user is in subdirectory X on drive Y, files can be 'seen' by his program only if they 
are in either subdirectory X or subdirectory SYSTEM. Files in any other subdirectory will not 
appear to exist. 

29.2.5 About Subdirectory SYSTEM 

It has been shown that files in the subdirectory named SYSTEM are special in that they 
can be accessed regardless of which subdirectory the user is 'in' on a specific drive. 
Likewise, a special situation also occurs when the user is 'in' the subdirectory named 
SYSTEM. When the subdirectory named SYSTEM is the current subdirectory on a given drive, 
all files on that drive are accessible regardless of which subdirectory they themselves are 
actually in. 

A little caution must be used when a user is in subdirectory SYSTEM on a disk with 
multiple files of the same name and extension. The caution is that, although each of the files 
IS still associated with one and only one subdirectory, all of the files on a disk are available 
when the user is 'in' the SYSTEM subdirectory. The result is that in this situation, one of the 
files of the desired name and extension will be referenced; which one is referenced is, 
however, undefined. Therefore, good practice dictates that if a user has more than one file 
with the same name and extension on some drive, that he make a point of always knowing 
which subdirectory he is in (and that it is not SYSTEM) if it matters to him which of his files 
he references. 

29.2.6 Files vs. the User Being 'in a Subdirectory' 

It is important not to confuse the two distinct concepts of a f/7e being in a subdirectory 
as opposed to that of {a u^ser} 'being in a subdirectory'. 

A file being in a specific subdirectory is a way of saying that the file cannot be 
accessed when the current subdirectory is neither that specific subdirectory nor SYSTEM. This 
relationship, that of a file being in a specific subdirectory, is retained more or less 
permanently; if a file is placed in subdirectory SUBDIR1 today on a disk, the disk can be 
removed and stored on a shelf; if tomorrow the disk is taken down from the shelf and 
re-mounted, that file will still be in subdirectory SUBDIR1. 

A user being in a specific subdirectory is a way of saying that the subdirectory in 
question is 'the current subdirectory' on one or more logical drives. The 'current subdirectory' 
on a drive is less permanent and reflects the use of the SUR command since the previous 
time the DOS was bootstrapped. 

As in most computer-related things, the best understanding of subdirectories is attained 
through experimentation. 
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29.2.7 Getting a File into a Subdirectory 



In general, there are three ways to get a file into a given subdirectory. The easiest and 
probably most common of these is automatic. Whenever a file is created, it is always placed 
into the current subdirectory on the drive on which it is created. 

Once a file has been thus created, it can be moved between subdirectories with the 
NAME command. The NAME command can take a file within the scope of the current 
subdirectory and put it into the current subdirectory if it is not already (which is useful if 
either the source or destination subdirectory is SYSTEM) or can place it into any other 
subdirectory the user might wish to put it into. 

29.3 USAGE 

The SUR command is parameterized as follows: 

SUR {<name>)|/<function>}{:DR<n>|{,<new name>} 

The function performed by SUR is determined by the absence or value of the 
< function > field and the name field, as described below. 

29.3.1 Establishing a 'Current Subdirectory' 

If the function field is not given, SUR establishes the named subdirectory as the current 
subdirectory on ail drives on which the named subdirectory exists. If the named 
subdirectory does not exist on one or more drives, the current subdirectory on any such drives 
is unaffected. If a specific drive is meritioned, then only the current subdirectory on the 
specified drive is subject to change. 

29.3.2 Creating a Subdirectory 

If the function field is /NEW, SUR creates the named subdirectory on all drives on which 
the named subdirectory does not exist. The current subdirectory is not affected by the 
operation. If a specific drive is mentioned, then the named subdirectory is only created on 
the specified drive. 

29.3.3 Deleting a Subdirectory 

If the function field is /DEL. SUR deletes the named subdirectory on any drives on which 
the named subdirectory exists. If any files are in the named subdirectory, they are moved to 
subdirectory MAIN before the named subdirectory is deleted. If the subdirectory being deleted 
is the current subdirectory on that drive, the current subdirectory is also changed to 
MAIN. Subdirectories SYSTEM and MAIN cannot be deleted. If a specific drive is mentioned, 
then the named subdirectory is only deleted from the specified drive. 
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29.3.4 Renaming a Subdirectory 

If the function field is /REN, SUR renames the named subdirectory on any drives on 
which the named subdirectory exists, to the name specified in the new subdirectory name 
field.lf any files are in the named subdirectory, they will be in the subdirectory specified by the 
new subdirectory name field upon completion of the operation. Subdirectories SYSTEM and 
MAIN cannot be renamed. If a specific drive is mentioned, then the name of the named 
subdirectory is changed only on that specified drive. 

29.3.5 Displaying Subdirectories 

if the subdirectory name field is not given, SUR displays the names of all subdirectories 
on all on-line drives. The format of the listing is similar to that provided for file names by the 
CAT command. The number in parentheses to the right of each subdirectory name is the 
subdirectory number associated with that name (in octal); an asterisk indicates the current 
subdirectory on each drive. If a specific drive is mentioned, then only the subdirectories 
present on the specified cjrive are displayed. 



SECTION 29. SUR COMMAND 29-5 



PART IV 



ADVANCED^^fjglp RAMMERS 



SECTION 1. INTRODUCTION 



1.1 General Background Information 

The object of an operating system is to allow maximal use of the capabilitie s f a a 
computer with minimal effort. A Datapoint 1100, 2200 Version 2, or 5500 computer with a 
Datapomt disk memory unit attached is capable of a very sophisticated mass information 
storage structure and a multitask environment. The sophistication of the mass storage 
structure allows efficient use of the available space while maintaining operator convenience 
and error recovery. The multitask environment allows the execution of several functions 
simultaneously. With the preceding in mind, a complete set of system routines and operator 
commands are provided. 

1.2 Operator Commands 

I ne operating system contains a routine that interprets user commands given at the 
keyboard and performs the tasks indicated. A large set of commands are supplied with the 
system which provide the user with facilities for creation, modification, and execution of files, 
along with a dynamic debugging facility. These include a general purpose editor and many 
useful disk file handling commands. A complete set of CTOS compatible cassette handling 
commands are also provided, allowing the user to transfer files between the disk and 
cassettes. 

Since the commands are actually programs which the system loads and executes to 
perform the task required, the command language is naturally extensible to include any 
program the user may desire, thus leading to a powerful keyboard facility. See Part III for 
information on the commands supplied with the system. 

1.3 System Structure 

The operating system proper resides within the first 8K of memory. Of this, only the first 
2.8K is necessary for the support of the disk. The debugging tool and CTOS compatible 
keyboard and display routines occupy through 4K, the cassette handler through 5.4K and the 
command handler through the rest. When the system is bootstrapped from the rear cassette, 
the first 768 bytes are loaded with a loader in the first 512 and entry point table and interrupt 
handler in the other 256. Note that since only the first 512 locations are necessary to load a 
file from the disk, any program that could be loaded by the cassette loader can be loaded by 
the disk loader. The small size of the disk file handling routines is due to the use of overlays 
for the file opening and closing functions. An overlay is also used to contain most of the 
system error messages, allowing fully descriptive messages without using a prohibitive amount 
of main memory. The basic DOS itself will run in 8K memory, but many of the commands 
require more than 8K. A 16K machine is strongly recommended. (Different considerations 
apply to Datapoint 5500 users due to the greatly expanded capabilities of the 5500 and hence 
its more powerful DOS). 
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The operating system supports one disk controller with one or more physical disk drives 
attached. Each physical drive contains one disk unit /vhich is considered to be one or more 
logical drives, each of which consists of a completely si)lf-contained information structure. 
Each logical disk can contain up to 256 files, the maximum length of any one of which being 
determined by the particular DOS in use; but in no Ccise may the size of any file exceed the 
capacity of the logical drive on which it resides. File space is allocated dynamically while 
maintaining as much physical contiguity as possible, t^ius enhancing access time and storage 
efficiency. 

1.4 Interrupt Hahdling 

A set of routines is loaded by the bootstrap that allows the user to make effective use of 
the interrupt facility in the Datapoint computers. These routines schedule the execution of 
interrupt driven processes, provide facilities for these processes to be turned on and off, and 
provide a mechanism via which these processes can be made to execute in a convenient 
manner. Note that since these routines are loaded only by the bootstrap action, interrupt 
driven processes are not stopped by the loading of the system or other programs. The DOS 
cassette handling routines make use of this interrupt facility to allow slewed reads and writes 
when moving data between the disk and cassettes, greatly increasing the rate of transfer. 

1.5 System Routines 

Routines within the operating system provide the programmer with facilities for dealing 
with the disk, cassettes, keyboard, and display. Each category of routine has an entry point 
table to allow system changes without necessitating a change in the user's code. Since each 
category has its own table, those routines not needed may be overlayed by the user. The 
keyboard and display routines are Identical in parameterization and function to the CTOS 
routines. The cassette routines perform the same functions as the CTOS routines but are 
parameterized differently. All of the routines execute with interrupts enabled and have a full 
set of error traps, enabling the user to deal with all errors except those fatal to the system. 

1.6 Physical Configuration Requirements 

The minimal physical configuration required to support the disk operating system is a 
Datapoint 1100, 2200 or 5500 computer (minimum 8K memory. 16K strongly recommended) and 
a Datapoint Corporation disk memory peripheral. (Note that the Version 1 2200 is not capable 
of running the DOS). As mentioned earlier, users with Datapoint 5500 computers and wishing 
to use the full 5500 disk operating system will need more than 16K, with the full complement 
of 48K user memory recommended. 

The choice of computer (1100, 2200, or 55(K)) and disk drive type (flexible diskette, 
cartridge disk, or full eleven-high disk pack drive) will determine which versions of DOS a user 
may choose from. 
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1.7 Program Compatibility with Different DOS 

The various versions of Datapoint DOS vary somewhat in internal disk structuring and in 
small related details. (Such detailed information is provided in the DOS System Manual 
corresponding to the user's individual DOS). In general, if a programmer uses the information 
contained in this User's Guide in writing his program, that program should run under any of 
the Datapoint Corporation DOS, without modification. 

Use of information contained within the DOS System Manual with regard to internal disl< 
structuring details, absolute physical locations of system tables, assumptions regarding the 
format and contents of internal physical disk addresses, and the like, should be avoided within 
user programs as it will tend to impair compatibility with different DOS and obstruct ease of 
future upgrading to higher capacity, more cost effective disks and more powerful processors. 
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SECTION 2. OPERATOR COMMANDS 



Files are identified from the console by a NAME, EXTENSION, and LOGICAL DRIVE 
NUMBER. The NAME must start with a letter and may be followed by up to seven 
alphanumeric characters. For many commands, this is the only information that must be 
supplied. The EXTENSION must start with a letter and may be followed by up to two 
alphanumeric characters. It further defines the file, usually indicating the type of information 
contained therein. For example, TXT usually implies user data files or source information (e.g. 
DATASHARE, ASM, DOS DATABUS, or SCRIBE source lines), ABS usually implies program 
object code records that can be loaded by the system loader, and CMD usually implies 
programs that implement commands given the DOS from the keyboard. Most commands have 
default assumptions concerning the extensions of the file names supplied to them as 
parameters. However, extensions may otherwise be considered as an additional part of the 
name. The LOGICAL DRIVE NUMBER specifies which logical drive is to be used. It is given 
in the form DR(n), where (n) is zero through the maximum supported within the user's 
configuration and the specific DOS he is using. If the drive is not specified, the system 
searches all drives starting with zero. Note that each logical drive contains its own directory 
structure. Specifying the drive number enables one to keep programs of the same NAME and 
EXTENSION on more than one drive. 

Files are always created implicitly. That is, the operator never specifically instructs the 
system to create a given file. Certain commands create files from the names given as their 
parameters. Since space allocation is dynamic, the operator never specifies how many records 
his file contains. 

Deleting files is made somewhat more difficult to protect the user from accidentally 
destroying valuable data. Files can be protected against deletion or both deletion and writing. 
In addition to this, the operator must always explicitly describe the file he is deleting and even 
then must answer a verification check stop before the actual deletion occurs. 

The system has no explicit RUN command since, to execute his program, the user simply 
mentions its name as the first file specification on the command line. This is the mechanism 
via which both commands and user programs alike are executed. The first file specification 
may be followed by up to three more, depending upon the requirements for parameterization of 
the program being run. A file specification is of the form: 

NAME/EXTENSION:DRIVE 

where any of the three items may be null (except the NAME must be given in the first 
specification which denotes the program to be run). Note that the / indicates that an 
extension follows and the : indicates that a device specification follows. If either of these 
items is not given, the corresponding denotation character is not used. For example: 

NAME/ABS:DRO NAME/ABS 
NAME:DRO 
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NAME 

are all syntactically correct. File specifications may be delimited by any non-alphanumeric that 
would not be confused with the extension and device indicators. For example: 

COPY NAME/TXT,NAME/ABS 
COPY NAME/TXT NAME/ABS 
COPY NAME/TXT/NAME/ABS 

will all perform the same function. If an extension is not supplied in the first file specification, 
it will be assumed to be CMD. in the above examples, COPY/CMD will be used for the 
complete file name sought in the directory for the command program name. Note that if one 
wanted to run a file he had created with extension ABS, he would simply enter 

NAME/ABS 

and his program would be loaded and executed. If the name given cannot be found in the 
directory or directories specified, the message 

WHAT? 

will be displayed. Note that the DOS can load any object code at or above location 01000 
(octal). However, if any use has been made of the interrupt handling facility, loading must be 
above 01400 or the system must be bootstrapped (by pushing RESTART) before 01000 through 
01377 may be overstored. This restriction arises from the fact that once the interrupt facility 
has been activated, a JUMP to a routine between 01000 and 01377 has been stored in 
locations 0, 1 and 2 and if this routine is overstored, the system will go astray upon 
occurrence of the next interrupt. 

See Part III of this manual for a full description of the command programs supplied with 
the DOS. 
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3.1 Disk Structure 

A disk, whether a flexible diskette, cartridge, or pack, is a self contained information 
structure when used with the DOS. A disk's tables reference only information on the disk 
itself, and it is assumed that the structure of the disk will not be changed without these tables 
also being changed. 

The smallest structural, unit of information on the disk is called a cluster and is 
composed of some fixed number of 256-byte sectors. (The number of sectors per cluster varies 
with different DOS but in general is between three and thirty-two sectors per cluster.) Clusters 
do not span track or cylinder boundaries, and one track of the disk will generally contain one 
or more clusters. Since the cluster is the smallest allocatable unit of storage on the disk, one 
cluster represents the minimum possible file size. 

Some small portion of each logical disk is reserved for several special tables maintained 
by the system. These tables include the Cluster Allocation Table (CAT), Lockout CAT, and the 
Directory. These tables are maintained in duplicate for backup purposes. This helps to insure 
that a software or disk error will not result in possible massive loss of data. 

The CAT is a bit map of the clusters that are not available for new space allocation. 
Each bit represents one cluster, and generally each byte represents one cylinder. Thus, the 
location of the byte in the table is equal to the number of the cylinder it is representing. Note 
that since not all 256 bytes are needed for this bit map (no supported disk has 256 cylinders), 
these excess entries are marked as not being available. However, since the DOS knows the 
maximum number of cylinders per disk, the entries above that number are never checked (thus 
leaving them free for other purposes). The last byte of the CAT is the auto-execute PFN, 
which specifies the physical file number of the file to be automaticaHy executed when the DOS 
is loaded. This number being zero implies that no file is to be automatically executed since 
physical file zero is the number of the DOS itself. 

The Lockout CAT is similar to the CAT but Is written only once, at the time of DOS 
generation of each disk. This sector is a copy of the CAT after the DOS GENERATION 
program has certified the disk but before any files have been allocated on it. It therefore 
provides a sector indicating which areas of the disk have been flagged as bad during the DOS 
GENERATION certification process. This is used in conjunction with the main CAT to avoid 
allocating files onto known bad places on the disk. 

The Directory consists of sixteen sectors. Each sector contains sixteen entries of sixteen 
bytes each. Each entry is associated with a number called the physical file number (PFN). 
This number is some function of the physical location of the entry in the directory (which 
function may vary for different DOS). 

The DOS loader (resides between and 01000 in memory) is parameterized by a logical 
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drive number and a physical file number. It indexes the directory on the given disk by the 
physical file number according to the individual DOS's directory mapping function to obtain the 
file's physical starting location (part of the information within the directory). Physical files 
zero through seven are reserved for system usage. File zero contains all of the code for the 
DOS {except for the overlays) that resides above location 01400. Files one through six contain 
code for executing the following functions: 

1 - PREP - create a new file 

2 - CLOSE - close a file and delete if indicated 

3 - OPEN - open an existing file 

4 - ALLOC - allocate more space for a file 

5 - ABORT ' display an error message 

6 - SCREEN - initialize the RAM display if present 

These are overlays that reside in the area between 04000 and 05400. File seven is used both 
by the DOS subdirectory facility, described In the SUR command section, and for the DOS 
FUNCTION overlays. 

The physical number of a file Is written in every record of that file for error control 
purposes. Otherwise, physical file numbers are used only to parameterize the system 
loader. At higher levels, files are parameterized by a symbolic name which is also contained 
within the directory entry. Other information contained within a directory entry is the physical 
disk location of the first cluster of the file, and protection bits to disable either deletion of the 
file or both deletion of and writing into the file. 

Note that the name as stored in the directory consists of eleven bytes of data. The 
command interpreter, which handles information given at the keyboard by the operator, deals 
with an eight byte name and a three byte extension (see Section 2). This is, however, purely 
a convention of the command interpreter and has no significance in relation to the internal 
format of the directory. When system routines which deal with file names are used, eleven 
bytes are provided for the parameter which is always dealt with as a monolithic item. 

A file consists of logically contiguous records (there is a one to one correspondence 
between records and physical disk sectors). These records are allocated in one or more 
physically contiguous groups of clusters where each contiguous group is called a 
segment. This segmentation is employed to allow the dynamic allocation and 
de-allocation of disk space without having to move information contained in other files. 

Internally, the DOS references records by a number, called the Logical Record Number 
(LRN). that starts at zero. The first two logical records (zero and one) contain a table 
followed by its copy that lists the location of each of the segments that make up the 
file. Logical records two through the last record in the file contain the user's data. These 
records are referenced by a number specified by the user that starts at zero. Therefore, 
system logical record two is user logical record zero. 

The table that describes the segments comprising the file is called the Retrieval 
Information Block (RIB). The working copy is kept in system logical record zero and its 
backup copy in record one. The backup copy is always written immediately after the working 
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copy IS wriiten. it exists to allow recovery if the working copy shows a parity failure in later 
use. Since, the 1100 and 2200 DOS always write with the write/verify mode of the disk 
controller, this situation should only occur if a power failure occurs while the working copy is 
actually being written on the disk (the actual writing of a sector on the disk surface only takes 
a millisecond or two, except for the flexible diskette). Since RIB updates occur infrequently, 
the probability of this kind of failure is extremely small. The CAT, Lockout CAT and Directory 
copies are treated in a manner similar to the treatment of the RIB copy for exactly the same 
reasons and exhibit the same small probability of requirement for backup. However, it is 
important that these backup facilities exist to prevent possible massive loss of the user's data. 

The figure on the following page depicts the file structure described above. Note that 
the logical record numbers indicated in the second figure are system numbers and that the 
LRN 2 shown is actually user LRN 0. The upper portion of the sketch shows the first segment 
broken down into its individual records. The first record points to all of the segments in the 
file (including the segment that contains the first record itself). The lower portion of the 
sketch shows the next segment broken down into its individual clusters. 



SECTION 3. SYSTEM STRUCTURE 3-3 



FILE STRUCTURE 
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The RIB contains the physical file number in its first byte, as in all records within the 
system, and a logical record number in the second two bytes, also as in all records within the 
system {the LRN of the working copy is zero and of the back-up copy is one). The fourth 
byte of the RIB always contains an 0377. The rest of the 252 bytes within the RIB contains 
up to 126 segment pointers (called descriptors). The first segment descriptor points to the 
segment containing the RIB Itself and always exists. If the list is shorter than 126 segments, a 
terminator consisting of two 0377's appears to denote that no descriptors follow. When the file 
is 126 segments long, the pair of 0377's does not exist. A single segment may be between 1 
and 32 clusters long. This length is specified by the rightmost five bits of the second byte in 
the descriptor which is the length minus one (thus the range of 1 through 32). The maximum 
of 32 clusters per segment is due to the five length bits available in the RIB's segment 
descriptors. An additional limitation exists which further reduces the maximum number of 
clusters per segment for certain DOS, that restriction being that the total number of sectors 
per segment must be less than 256. The left three bits of the second byte, together with the 
first byte, specify the cluster where the segment begins. The following figure shows the format 
of the RIB: 



RIB FORMAT 



PFN 



LRN 




01 



0377 



SEGMENT 
DESCRIPTOR 
1 



SEGMENT 

DESCRIPTOR 

2 



0377 
0377 



► RIB COPY IS LRN 1 



CAUSES LOADER TO SKIP RIB'S 



CYLINDER 



I I 

-L.,JL 



CLUSTER 
NUMBER OF 
FIRST ONE 
IN THE 
SEGMENT 



T — I — I — r 
jj I.I I 



NUMBER OF 
CLUSTERS 
MINUS ONE 



SECTION 3. SYSTEM STRUCTURE 



3-5 



3.2 Disk Data Formats 

The DOS itself does not deal with the user's data below the record level. It only keeps 
track of where the records are, allowing the user to format the data in any manner he 
pleases.The user is presented with records that are 253 bytes long. The system keeps the 
physical file numt>er in the first physical location of each sector and the system logical record 
number of the given record in the second (LSB) and third (MSB) physical locations of each 
sector. This is done to insure that the record obtained is the record desired. The last 253 
bytes may contain anything the user chooses. There are, however, some assumptions made by 
the DOS and the programs supplied with it that deal with disk data. These assumptions fall 
into two classes: system loader object records and symbolic data records. The first class 
contains all records that are to be loaded into memory by the DOS loader. The second class 
contains all records that are to be handled by the standard data handling programs. These 
programs include the general purpose editor, the assembler, DATASHARE, RPG II, DOS BASIC, 
and the DATABUS programs (both source lines for the various compilers and data records 
handled by the resulting programs). 

A record that is to be loaded by the system loader must have the following format: 
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3.3 Memory Mapping 

The DOS occupies memory as shown by the following map: 



N 



COMMAND 
OVERLAYS 



COMMAND 
INTERPRETER 



CASSETTE 
DRIVERS 



DOS FUNCTIONS 



DEBUG 



KEYIN & DISPLAY 



FILE HANDLING 
OVERLAYS 



DISK FILE 
HANDLING ROUTINES 



DATA AREA 



ENTRY POINTS & 
INTERRUPT HANDLER 



SYSTEM LOADER 



N 



020000 (8K) 



017000 



012400 



010000 (4K) 
07400 



05400 



04000 {2K) 



02000 
01400 
01000 





SECTION 3. SYSTEM STRUCTURE 



3-7 



3.4 Memory Tables 

A number of entry point tables exist within the DOS. These tables consist of a group of 
jumps to the various routines made available to the user. These jumps allow the system to be 
changed without requiring the us^r to reassemble his programs. 

The first entry point table is located between 01000 and 01377. It contains entry points 
to the routines in the loader (the loader itself, the basic disk read and write driver, and the 
interrupt handler) and the DOS file handling routines. It also contains in-line routines to 
increment and decrement the HL registers. These routines are coded in-line and constructed 
in a fashion to enable the A-register to contain the increment or decrement value and the 
entry point plus two entered for incrementation or decrementation by a number other than one. 

The second entry point table is located between 010000 and 010066 and contains entry 
points to the cassette handling routines. The third entry point table is located between 013400 
and 013452 and contains entry points to routines within the command interpreter. The 
availability of the command interpreter routines makes small command tasks easy to implement 
as can be seen by inspection of the assembly listings for the commands supplied with the 
DOS. See Sections 5 and 7 of Part IV of this manual for more details on the routine functions 
and entry point locations. 

The major working table in the system is called the Logical File Table (LFT) and is 
located from 01544 through 01643. It contains all of the information required by the file 
handling routines for every file which is currently open (a maximum of three files may be open 
at any one time - logical files one, two, and three). Once the user has opened a file by its 
symbolic name, he deals with It by the logical file number under which it was opened. The 
LFT entry keeps a record of the segment currently being dealt with. If the record being 
accessed (specified by the LRN in the following table) is within the current segment 
(determined from the BLRN and CSD in the following table), the physical disk location can be 
determined from the information in the LFT (all LRN's in the LFT are system 
LRN s). Otherwise, the RIB must be read and a new current segment established. Note, 
however, that a maximum of only two disk accesses are necessary to randomly access any 
piece of information within a file and sequential accesses require only one disk access in most 
cases. 

The LFT contains for each entry the following information in the order shown (the 
number in parenthesis is the number of bytes used for the item): 

- Physical File Number 

- Physical Drive Number and Protection 

- Next LRN to be dealt with 

- First LRN within the current segment 

- Current Segment Descriptor 

- Physical Disk Address of RIB (MSB) 

- Physical Disk Address of RIB (LSB) 

- Largest LRN referenced 

- Largest LRN allowed (obsolete) 
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BUFADR (1) - Current controller buffer address 
XXXXXX (1) - Not used 

There are actually four LFT entries to correspond to buffers 0-3 in the disk 
controller. However, the first entry (logical file zero) is reserved for system usage because the 
DOS needs a buffer into which it can read the RIB if it is necessary to determine a new 
current segment when a given access is made. This need is only critical on writes when the 
buffer contains the information to be written to the disk and the system must then read the 
RIB into a different buffer. On reads, the user's data will always be the last item to be read 
and logical file zero can be used. One must exercise caution in the use of logical file zero, 
however, since an access involving a different logical file may cause logical file zero's disk 
buffer to be loaded with a RIB. Also, the zeroth disk controller buffer is always used by the 
system loader in transferring data to memory. This last fact implies that the user may load an 
overlay or chain to another program without any of the standard (one through three) logical 
files being perturbed in any way. The other thing that is special about logical file zero is 
that CLOSES have no effect when issued on it. This means that neither space deallocation 
nor updating of the protection field occur when logical file zero is closed. This is true 
whether the close is done by explicitly calling CLOSES or implicitly by calling other system 
routines (e.g. PREP$, LOADS, RUNS, etc.) 

The DOS loader uses a set of locations in memory locations 4 through 022 to perform 
the functions of an LFT entry during the loading process. It knows, however, that an object 
file is always sequential and does not have to have the accessing generalization of the main 
file handling routines. This is the main factor in the small size of the DOS loader. The file 
handling routines also use these low memory locations for temporary storage of a specified 
LFT entry to eliminate having to contmually index into the LFT. Also, since the basic disk 
read and write routines use location 5 to indicate which drive is to be used, having the LFT 
temporarily stored in the low memory locations automatically selects the correct drive for use. 



3.5 The Command Interpreter 

Section 2 of this manual describes the operation of the DOS from the system 
console. When the command interpreter is entered, it checks to see if a program has been 
set to be automatically executed. If it has, the program is loaded and executed (unless the 
KEYBOARD key is depressed). Otherwise, the command interpreter attempts to obtain a 
command line from the keyboard. While it is waiting for this line, the command interpreter 
runs a test on the disk controller buffer memory while checking the keyboard ready status 
bit.When the keyboard becomes ready, the test is stopped and the keyin routine entered (which 
will get the character that made the keyboard become ready and then key in the rest of the 
command line - note that even striking just the CANCEL key will stop the disk buffer memory 
test). 

>» 
The command interpreter resides in locations 012400 through 020000. Actually, the area 

between 017000 and 020000 is used as an overlay area by many of the commands supplied 

with the system, thus eliminating the need to reload the DOS after the execution of every 

command. The interpreter keys a command line into a place in the data area of the DOS 

called MCR$ (Monitor Communication Region, locations 01400 through 01543). It then scans 
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this line with lexical scanning routines that are made available to the user through the 
command interpreter entry point table. The IN command and the #(which causes entry into 
the debugging tool), are handled as special cases. Otherwise, the first name given is opened 
as logical file zero and that program loaded and executed. The program that is loaded has 
access to the command line in MCR$ and thus programs may be parameterized by information 
given after the program name. 

The command interpreter scans up to four file specifications from the command 
line. These specifications are entered in a normalized symbolic form into the corresponding 
logical file table entries. Note that this is not the normal logical file table Information but that 
these locations are simply being used as a temporary storage for the symbolic information that 
has been lexically normalized by the command interpreter. The program loaded may simply 
check that all the necessary information has been supplied and/or supply any assumed 
portions, and then use this data as a name parameter to the file opening or creating 
routine. The opening routine has no difficulty using a name that is supplied as its parameter 
in the same locations as the logical file table entry it Is going to set up. 

When a program receives control from the command interpreter after having been 
invoked via a command line from the keyboard, each of the LFT entries one through three (but 
not zero) contain the following: 

DRCODE (1) - Drive select code (described below) 

0377 (1) - Indicates file is closed 

FILENAME (8) - File name specified (or eight spaces) 

FILEEXT (3) - File extension specified (or spaces) 

DRSPEC (3) - Logical drive specification (or spaces) 

The drive select code contains one of the following: 

0377 - No drive spec entered (DRSPEC is spaces) 

0376 - Nonstandard, probably invalid, drive spec 

Otherwise - The given logical drive number, in binary. 

Note that most DOS system routines allow 0377 as a drive number, indicating 'scan all 
drives'. (This is the reason why 0377 is the no-drive-specified code; programs need no longer 
treat this as a special case). Example program usage: (prepare file specified in LF2 file spec, 
defaulting extension to TXT) 



TXT 


DC 


TXT' 


START 


MLA 
CP 


•LFT+LF2+10 




JFZ 


NODEF 




LEL 






LDH 






HL 


TXT 




LC 


3 




CALL 


BLKTFR 


NODEF 


MLA 


•LFT+LF2+2 



Default extension 
Get first byte of ext. 
Check if It's blank 
If not, leave it alone 



Else default to 'TXT' 



Make sure name was given 



3-10 
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GP 


■ 


HL 


NAMREQ 


JTZ 


CMDAGN 


MLA 


♦LFT+LF2 


CP 


0376 


HL 


BADEXT 


JTZ 


CMDAGN 


LCA 




DE 


LFT+LF2+2 


CALL 


PREPS 



And if not, get address 

of 'NAME REQ' message 

And return with it 

Check file extension 

for validity and if bad 

give 'INVALID DRV message 

Get drive #(N,0377) into C 
DE =>name, extension 
And it's done. 



Note that programs which receive control upon DOS startup (programs which have been 
set for AUTO-execute) do not generally receive control via the command line mechanism and 
hence the contents of both MCR$ and the LFT are initially undefined when such programs are 
entered. Any program which is to be set for automatic execution will therefore have to take 
this factor into consideration, and perhaps make special provisions as it may require. (A utility 
program called AUTOKEY exists which remedies this situation, and is released with the DOS). 
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SECTION 4. INTERRUPT HANDLING 



4.1 Scheduling 

When the system is loaded with the bootstrap function (RESTART depressed), the 
following set of CALL instructions are loaded into the area between 01000 and 01377 (just 
above the main entry point table for the DOS): 



INTRPT 


Dl 




Disable interrupts 




BETA 




Use BETA mode 


INTO 


CALL 


RETURN 


Do the four 


INT1 


CALL 


RETURN 


one millisecond 


INT2 


CALL 


RETURN 


routines 


INT3 


CALL 


RETURN 






MLA 


♦INTSCN 


Rotate to the 




AD 


6 


next one of the 




LMA 




four millisecond 




AD 


INT4-6 


routines 




LLA 


I 


HL =CALL address 




PUSH 




Jump to the 


RETURN 


RET 




next CALL 


INT4 


CALL 


RETURN 


Four millisecond 




JMP 


INTRET 


routine table 


INT5 


CALL 


RETURN 






JMP 


INTRET 




INT6 


CALL 


RETURN 






JMP 


INTRET 




INT7 


CALL 


RETURN 






XRA 




Reset the scan 




MSA 


♦INTSCN 


pointer 


INTRET 


ALPHA 




Back to ALPHA mode 




El 




Enable interrupts 




RET 




Back to the background 



Foreground routines are executed by being called by one of the above CALL 
instructions, and run only in BETA mode with interrupts disabled. Note that the only way for a 
foreground routine to return to the scheduler is via a RETURN instruction. Therefore, the 
routine must always leave the subroutine call address stack in the same state it was in when 
the routine was entered. ' This means that a foreground routine can not call a subroutine that 
then returns to the interrupt scheduler because this would leave the stack with an address it 
did not previously have. Subroutines that must wait for another interrupt must be handled by 
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storing the return address into a memory location somewhere (usually most conveniently into 
the address portion of a jump instruction, as it turns out). 

4.2 Process Initialization 

When bootstrap occurs, a return is stored in location zero to cause interrupts to have no 
effect. This enables the loader to be completely self-contained belov^/ location 01000, able to 
load all programs that could t>e loaded by the cassette loader, and still able to run with 
interrupts enabled. Whenever an interrupt routine is activated, however, locations 0, 1, and 2 
are loaded with a jump instruction to the label INTRPT in the preceding code. This activates 
the interrupt scheduler and is also the reason why programs should not be loaded below 
01400 after the interrupt handling facilities within the DOS have been used. 

Once the jump instruction has been stored, the interrupt scheduler is executed every 
millisecond. Note that initially none of the CALLs would have any effect, since ttiey all call a 
RETURN instruction. When an interrupt driven routine Is initiated, however, its address is 
stored into the address portion of the CALL instruction, causing that routine to be executed. 
Interrupt driven routines are always initialized from the background program by the routine 
SETI$, which stores the address given in the D and E registers (MSB and LSB respectively) 
into the CALL instruction whose number is given in the C register (the number corresponding 
to the digit shown in the labels on the CALL Instructions in the preceding code). The first 
four CALLS are executed every millisecond and the second four CALLs are rotated in 
execution causing any particular one to be executed only once every four milliseconds. Since 
the interrupt scheduler is entered every millisecond, the execution time for the one four 
millisecond and four one millisecond routines should not total more than one millisecond 
average to prevent an interrupt from being dropped. 

The execution of the foreground process can be stopped in two ways. There is a 
background routine called CLRI$ which simply sets the D and E registers to the label RETURN 
in the preceding code and executes the SETI$ routine. There is also a foreground routine 
called TP$ which will be discussed after the explanation of process state changing. 

4.3 PfOGSSS Ststs Oiisn^in^ 

Once an address has been stored in a particular CALL instruction, the same location will 
be entered upon each execution of that CALL. This location is called the state of the 
foreground process. A routine exists above the interrupt scheduler (still below 01400) which 
allows the state of the process to be changed to the location following the call of that routine. 
The routine, shown below, is called CSS for Change State: 



CSS 



POP 




DE =the address 


LEL 




after the CALL 


LDH 




instruction 


POP 




HL =the address 


PUSH 




of the CALL to 


CALL 


DECHL 


this process 
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LMD 
CALL 
LME 
RET 



DECHL 



Change the address 
in the CALL to 
this process 

Back to the scheduler 



This routine obtains the new state address by popping the stack. It assumes that after 
doing that, the stack is in the same state it was when the process call was executed, and thus 
can obtain the location of that call by popping the stack again. (This implies that CSS should 
not normally be called from a subroutine within an interrupt-driven process, but only from 'level 
zero' of the foreground process). It does this and stores the new address in the process call. 
It then executes a RETURN to give control back to the interrupt scheduler, thereby causing 
execution of that specific foreground process to wait until the next time the process call is 
executed. 

A routine called TP$ exists which simply loads the D and E registers with the location 
RETURN in the interrupt scheduler code shown earlier and jumps to the second POP 
instruction in CS$. This routine is jumped to (not called) and, as mentioned before, terminates 
the execution of the forfegrolind process. 

At this point an example is appropriate. To simplify the discussion, it will be assumed 
that the process CALL has been initialized to the location LA3EL1. The following routine 
decrements a memory location called COUNT until it becomes zero and then changes its state 
to the location LABEL2, which waits for the keyboard status bit to be set and then obtains the 
character entered and continues with processing. Note that this has the effect of causing a 
delay of the number of milliseconds equal to the number that was initially in COUNT before 
continuing on to checking the keyboard and processing the character. 



LABEL1 



LABEL2 



MLA 


•COUNT 


Get the count 


su 


1 


Decrement it 


LMA 




Update memory 


RFZ 




Back to the scheduler 


CALL 


CS$ 


Change state if zero 


LA 


0341 


Then start checking 


EX 


ADR 


the keyboard 


IN 




Wait for KBD 


ND 


2 


ready 


RTZ 




Back to the scheduler 


EX 


DATA 


Unless KBD ready 


IN 




Then get the key 
Etc. 



The following is a narrative of what takes place. It will be assumed that interrupt zero 
(INTO) has been initialized and the jump instruction to INTRPT stored in locations 0, 1, and 2. 
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upon occurrence of the next interrupt a jump to INTRPT occurs, interrupts are disabled, and 
the processor switched to BETA mode. A CALL to LABEL1 is then executed by the 
instruction at INTO. LABEL1 loads the A-register with the contents of COUNT, decrements it, 
and stores the result back into COUNT. If the result is not zero, the return is executed and 
the rest of the CALLs in the interrupt scheduler are executed, the processor switched back to 
ALPHA mode, interrupts enabled, and control passed back to the program that was interrupted. 
If the result is zero, CS$ is called. It gets the location LABEL2 by popping the stack into the 
DE registers. It then gets the location INT1 by popping the stack into the HL registers but 
leaves this value on the stack. It then stores the DE register values (equal to the address 
LABEL2) into the CALL at INTO and returns, causing execution to continue at INT1. When the 
next interrupt occurs, the CALL at INTO will be to LABEL2. 

4.4 Timing Considerations 

As mentioned before, the programmer must be careful with the amount of time he uses 
when constructing interrupt driven routines. Since the interrupt scheduler is entered every 
millisecond, the total execution time of the four one millisecond calls and the one four 
millisecond call must not average over one millisecond if no interrupts are to be missed. 
Because of this time restriction, the calls that are rotated in execution were constructed to 
allow processes which do not require the higher rate to not impose as much overhead on the 
system. When one is constructing a foreground process and discovers that its execution time 
is becoming excessive, he must break it down into several states with each state using a more 
appropriate amount of time. Note that the interrupt scheduler itself uses 130 microseconds 
when there are no processes active. 

(Timings given here and elsewhere relate to the Datapoint 1100 and 2200 Version II 
processors. Users with Datapoint 5500 computers (and not concerned with downward 
compatibility with Datapoint 1100 and 2200 processors) will find that its increased speed allows 
less restriction on the execution time of foreground driven processes, assuming that the 5500 
DOS is running in single partition mode.) 

The 1100, 2200, and 5500 each contain a crystal controlled clock which causes an 
interrupt signal every millisecond plus or minus 500 nanoseconds (.05%). When this signal 
occurs, a flag within the processor, called Interrupts Pending, is set. Upon the occurrence of 
an instruction fetch cycle when interrupts are enabled and Interrupts Pending is set, the 
processor clears Interrupts Pending and executes a CALL to location zero instead of 
performing the normal instruction fetch. This implies that the processor buffers interrupts one 
deep since Interrupts Pending will remember the occurrence of an interrupt until they are 
enabled. Note that there is a delay between the actual time when the one millisecond signal 
occurs and the time when the CALL to location zero is performed. This delay is equal to the 
length of time between the occurrence of the interrupt signal and the occurrence of a fetch 
cycle when interrupts are enabled. Since the interrupt signal is asynchronous to when the 
background program will have interrupts disabled and even to when fetch cycles occur, jitter 
in the execution of the interrupt scheduler with relation to the actual occurrence of the 
interrupt signal is introduced. This jitter is of prime concern when dealing with interrupt 
processes and its sources and analysis for purposes of program construction are treated in the 
following paragraphs. 
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There are two major sources of interrupt execution jitter. The first is interrupts being 
disabled. The background program must disable interrupts whenever it has the system in a 
state that cannot be restored by the interrupt scheduler. The interrupt scheduler assumes that 
the background does not use the BETA mode of the processor and, therefore, that it can be 
used without being restored when control is returned. Because of this, the background 
program must have interrupts disabled whenever the BETA mode of the processor is being 
used. 

The other system state that cannot be saved is that of the I/O devices. When interrupts 
are active and the Interrupt driven routines are performing input or output operations, the 
background routines must either not do any I/O or must disable interrupts when dealing with a 
device. If a background routine addresses a given device without first disabling interrupts, it 
could be interrupted before getting around to using that device and the interrupt routine could 
address some other device. When control is passed back to the background routine, it will 
proceed with its I/O operation thinking that the device it addressed is still addressed, whereas 
the device that the interrupt routine accessed is the one actually addressed and confusion will 
occur. Therefore, any I/O operations performed by the background program must have 
interrupts disabled from before the time the device is addressed until after it is used. 

Care must be exercised when disabling interrupts in the background program to prevent 
the loss of an interrupt. Since Interrupts Pending is only one bit of information, the 
occurrence of another interrupt signal before the previous one is processed will result in the 
state of Interrupts Pending not changing (since it will simply be set again and it is already 
set) and, therefore, the occurrence of the second interrupt will not be reflected in the state of 
the processor. This means that if interrupts are disabled for more than one millisecond, an 
interrupt will be dropped. In practice, interrupts should not be disabled in the background for 
more than a few hundred microseconds for the following reason: 

Suppose an interrupt process is active which is taking characters from 
a device at the rate of 700 per second. This implies that a character 
must be taken from this device on the average of one every 1.4 
milliseconds (if the device contains a one character buffer). Suppose 
further that the interrupt process polled the device just before the next 
character became available. At this point, the process has about 1.4 
milliseconds to get the next character before it will be overstored by 
the following and cause a loss of data. Normally, if interrupts were 
enabled, the interrupt process would poll the device about 1.0 
milliseconds later and get the character with time to spare. However, if 
the background routine disabled interrupts for 500 microseconds just 
before the next interrupt occurred, the interrupt process would not be 
executed soon enough and a data character would be lost. 

As the above example shows, the actual execution time of the interrupt 
processes can be caused to jitter due to the background routine disabling interrupts. 
The worst case jitter is exactly equal to the maximum amount of time the background 
routines disable interrupts. The DOS routines disable interrupts no longer than 200 
microseconds. The maximum time tolerable is equal to the difference between the 
time between interrupts (1000 microseconds) and the minimum time between necessary 
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interrupt process executions (1400 microseconds in the case above). 

Another source of jitter can be in the execution time of the foreground 
processes themselves. The jitter time for interrupt zero is exactly equal to that due to 
interrupts being disabled. However, interrupt one is not executed until after interrupt 
zero and if interrupt zero consumes a different amount of processor time on each 
interrupt, interrupt one's execution time will vary with respect to when interrupt zero 
started execution. This is an additional jitter factor which must be calculated for 
interrupt one. The same is true for the interrupts that follow, but they vary even more 
since the start of each succeeding interrupt process depends upon the total of the 
execution times of all of the proceeding interrupt processes. 

4.5 DOS Usage 

The DOS itself (i.e. excluding command programs running under the DOS) uses 
the interrupt facility in only two places. One is the debugging tool's dynamic 
P-counter display (if it is turned on; uses interrupt zero) and the other is for the 
cassette handling routines when used (uses interrupt one). Both of these routines 
introduce a maximum of 400 microseconds of jitter and consume an average of 150 
microseconds of processor time (with peaks of 500 microseconds). 

Users with Datapoint 5500 computers and running the full 5500 DOS must 
consider other details relating to timing of foreground routines, particularly on 
foreground routines that deal with non-DOS supported I/O devices. These details 
will be dealt with more fully in the DOS System Manuals for the appropriate DOS. 
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5.1 Parameterization 

Parameters are passed to the subroutines through the registers. In the discussion of 
these parameters, the following abbreviations will be used: 

LFN - Logical File Number times 16 (16, 32, or 48) 
LRN - Logical Record Number (the user's LRN) 
PFN - Physical File Number 
LFT - Logical File Table 

also: 

Drive Number - indicate a logical drive number (0-N). (N varies with the DOS in use, but 
in general will be 2**X-1; typically 3, 7, or 15). In some routines, 0377 is 
used to indicate that all drives are to be checked. 

Name- the address of a field containing exactly eleven bytes. The first eight bytes are 
the file name and the last three bytes are the file extension by command 
interpreter convention. The name characters may be any eight bit 
combinations except the first character must not be a 0377. The command 
interpreter requires that the first and ninth characters be letters and that the 
remaining be letters or digits with trailing spaces. 

5.2 Exit Conditions 

When a routine is called, it can either perform the expected action or not. In the 
second case, some Indication must be made that the expected action did not occur. This is 
achieved by the condition flags in the processor being set in a special manner or by control 
being transferred to a trap location instead of being returned via the subroutine mechanism. 
The 'Exit conditions' section of each subroutine description shows the register contents and 
condition flags of interest when the routine returns. 

5.3 Error Handling 

There are fatal and non-fatal errors. Fatal errors suggest that the program is 
hopelessly confused and the only recourse is to display vyhat the problem appears to be and 
reload the operating system. This is usually the result of a call being incorrectly 
parameterized or the system tables on the disk being unusable. The messages displayed are 
explained in Section 6. 

Non-fatal errors concern various conditions such as parity failures in the user's data, 
records of illegal format, violations of a file's protection, or physical end of cassette. In 
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some cases these conditions can be detected upon the routine's exit as explained in Section 
5.2. In the other cases, control is passed to a specified location (to the error message 
routine if no location has been specified by the user) instead of being returned via the 
normal subroutine exit mechanism. 

There are actually two sets of traps. The first deals with the disk routines and the 
second deals with the cassette routines. The disk routine traps are described under Section 
5.6 and the cassette routine traps are described under Section 5.9. The Traps' section of 
each subroutine description Indicates what conditions will cause the relevant traps. These 
traps are referenced by mnemonics which are defined in the section where the trap setting 
routines are described (5.6.17 and 5.9.12). 

S.4 Foreground Routlnos 

Section 4 contains a complete discussion on the functioning and use of the foreground 
handling and should be consulted for an understanding of the following routines. 

5.4.1 C8$ - Change process slate 

CS$ changes a foreground routine's state. It is called by the executing foreground 
routine and causes its execution address to be changed to the address following the CALL 
CS$. Execution will not continue at the new address until the next interrupt occurs. CSS is 
normally called from the outermost level (level 0) of an active foreground process. 

Entry point: 01033 

Parameters: on subroutine stack - see Section 4 

Exit conditions: return is made to the scheduler 

5.4.2 TP$ - terminate process 

TP$ deactivates the process called by storing the address of a return instruction in the 
process call. TP$ is jumped to, not called. TP$ is invoked from the outermost level {lave! 0) 
of an active foreground process. 

Entry point: 01036 

Parameters: on the stack - see Section 4 

Exit conditions: no exit 

5.4.3 SETI$ - initiate foreground process 

SETI$ activates the interrupt process specified by the number in the C register (0-7) by 
storing the address given in the D and E register into the CALL instruction for that process 
Interrupt processes zero through three are executed every millisecond while four through 
seven are executed every fourth millisecond. 
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bntry point: 01041 

Parameters: c =process number (0-7) 

DE =address of foreground process 

Exit conditions: B,D,E unchanged 

H,L =0 

5.4.4 CLRi$ - terminate foreground process 

CLRI$ deactivates a foreground process by storing the address of a return instruction 
into the process cati specified by the number in the C register (0-7). 

Entry point: 01044 

Parameters: c =process number (0-7) 

Exit conditions: B,D,E unchanged 

H,L =0 

5.5 Loader Routines 

There are two levels of disk handling routines. This section describes the lower level 
routines which reside in the loader and require numbers physically describing the drive, 
cylinder, sector, buffer, and file. Section 5.6 describes the upper level routines. 

INCHL and DECHL are described in this section only because they are used by the 
DOS at all levels and because these two routines are loaded as part of the bootblock. In 
general, the other routines described In this section (5.5) are not used by typical user 
programs; most user programs will be better served by the higher level routines described in 
section 5.6. 

5.5.1 BOOTS - reload the operating system 

BOOTS loads and executes the- operating system (PFN on logical drive 0). This action 
does not effect the interrupt handling facility between 01000 and 01377. Since BOOTS 
requires that the operating system always be loaded from specifically drive zero, BOOTS 
should normally only be used in cases where EXITS is unusable, for example if the disk 
handling routines have been overstored. BOOTS does not close any files before reloading 
the DOS. 

Entry point: 01000 

Parameters: none 

Exit conditions: does not return 
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5.5.2 RUNX$ - load and run a file by numbar 

RUNX$ loads the physical file specified and begins its execution. If the file cannot be 
loaded, a jump to BOOTS occurs. 



Entry point: 
Parameters: 



01003 

A =PFN 

C =Drive Number 



Exit conditions: does not return 

5.5.3 LOADX$ - load a file by number 

LOADX$ loads the physical file specified and returns with the starting address in HL if 
the load was successful. 



Entry point: 
Parameters: 

Exit conditions: 



01006 

A =PFN 

C =Orive Numt>er 

Carry false: HL =Starting address of file 
Carry true: A=0 if file does not exist 

1 if drive off line 

2 if directory parity fault 

3 if RIB parity fault 

4 if file parity fault 

5 if off end of physical file 

6 if record of illegal format 



5.5.4 INCHL - increment the H and L registers 

INCHL increments the sixteen bit value in the HL registers by one. If the routine is 
entered at INCHL+2, the sixteen bit value in the HL registers will be incremented by the 
number in the A register. 



Entry point: 
Parameters: 

Exit conditions: 



01011 (01013 for increment by A) 

HL =numl>er to be incremented 

A =increment value if INCHL+2 used 

HL incremented 

A equal to the H-register 

B,C,D,E unchanged 



5-4 
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5.5.5 DECHL - decrement the H and L registers 

DECHL decrements the sixteen bit value in the HL registers by one. If the routine is 
entered at DECHL+2, the sixteen bit value in the HL registers will be decremented by 
negative the number in the A register (e.g., for decremention of 2, A is set to -2). 

Entry point: 01022 (01024 for decrement by -A) 

Parameters: HL =number to be decremented 

A =decrement value if DECHL+2 used 

Exit conditions: HL decremented 

A equal to the H-register 
B,C,D,E unchanged 

5.5.6 GETNCH - get the next disk buffer byte 

GETNCH gets the character from the physical disk buffer location pointed to by low 
memory location BUFADR (location 026) from the disk buffer currently selected and then 
increments the contents of the location BUFADR. Note: Do not confuse the low-memory 
location BUFADR used by GETNCH with the 4 fields called BUFADR in the LFT. 

Entry point: 01047 

Parameters: BUFADR =disk buffer address (0-255) 

Exit conditions: A =character from disk buffer 

BUFADR =BUFADR+1 
B,C,D,E,H.L all unchanged 

5.5.7 DR$ - read a sector into the disk buffer 

DR$ causes a sector to be transferred from the disk to one of the disk controller 
buffers. The drive number is given in the least significant bits (the others are ignored) of 
location PDN (5). (The number of bits ignored depends upon the particular DOS in 
use). The physical disk address (LSB) is given in the E register and the physical disk 
address (MSB) is given in the D register. The disk controller buffer number times sixteen is 
given in the B register. Interrupts are disabled by this routine a maximum of 100 
microseconds. 

Compatibility note: Here the user should be reminded that the physical disk address 
format will vary; the user's program should not make assumptions regarding this format if 
the program is to be transportable between different DOS. The most significant byte is 
generally a cylinder number, and the least significant byte is a sector address within a 
cylinder. This least significant byte will generally be the more at variance among DOS. In 
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general, the only safe way to insure a valid, proper physical disk address (PDA) is to get it 
as a returned item from a system routine (POSITS or one of the DOS FUNCTIONS, to be 
described later). User program generation of or manipulation of physical disk addresses is 
strongly discouraged. 

DR$ tries up to four times to read a record, if parity faults are detected, before giving 
an abnormal exit status, Ndte that since this routine is used by all of the higher level 
routines, all disk reads performed by the disk operating system try to read a record that 
shows parity problems up to four times before giving up. 

Entry point; 01052 

Parameter B =16 times buffer number (0,16,32,48) 

D =physical disk address (MSB) 
E == physical disk address (LSB) 
PDN (at loc 5) =loglcal drive number 

Exit conditions: B,D,E,PDN all unchanged 

Carry false if read successful 
L =252 + number of retries required 
Carry true and Zero false if drive off line 
Carry true and Zero true if parity fault 



5.5.8 DW$ - write a sector from the disk buffer 

DW$ causes the contents of one of the disk controller buffers to be transferred to a 
sector on the disk. If the write protection on the specified drive is enabled, DW$ will beep 
continuously until the protection is disabled. 

There are two types of write protection in the disk operating system. The first type is 
a physical protection that is part of the disk drive hardware which will cause DW$ to beep if 
set. The second type of write protection is a logical protection that is connected with each 
file on a disk. A bit exists in the directory entry for each file which, ii set, win prevent tuG 
higher level routines (for example, WRITES) from calling the DW$ routine. It is important not 
to confuse these two types of write protection. All references to write protection that follow 
refer to the logical protection on each file and not to the physical protection on the drive 
itself. 

* 

In the 1100/2200 series DOS, DW$ uses the write/verify mode of the disk controller. 
This implies that all writes made by these disk operating systems use this mode of writing. 
As in the DR$ routine, up to four tries will be made if parity faults occur before abnormal 
exit will occur. In all other respects, DW$ is similar to DR$. 

Entry point: 01055 

Parameters; B =16 times buffer number (0,16,32,48) 

D =physical disk address (MSB) 
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E =physical disk address (LSB) 
PDN (at loc 5) =drive number 

Exit conditions: B,D,E,PDN unchanged 

Carry false if read successful 
L =252 + number of retries required 
Carry true and Zero false if drive off line 
Carry true and Zero true if parity fault 

5.5.9 DSKWAT - wait for disk ready 

DSKWAT waits for disk ready, controller ready, no disk I/O transfer in progress, and 
drive online to all be true. If the drive is not online, return is made with the carry flag true, 
the zero flag false, and interrupts enabled. Otherwise, exit is made with interrupts disabled. 

Entry point: 01060 

Parameters: none (drive checked is the selected drive) 

Exit conditions: explained above 

B,C,D,E,H,L unchanged 

5.6 File Handling Routines 

A file is dealt with as a logically contiguous and randomly accessible space. The file 
being used is specified by its symbolic name {see 5.1). The LRN being dealt with within that 
file is determined by a two-byte number kept within the system {LRN in the LFT). When a 
file is opened, this number is set to two. 

A bit of explanation may be called for here. This two corresponds to user logical 
record number zero; the LRN in the LFT is the system LRN. System LRN zero is the primary 
RIB for the file and system LRN one is the RIB backup. System LRN two is the first user 
data sector. It is important to recognize this distinction between system and user logical 
record numbers. All logical record numbers supplied to system routines (e.g. POSITS) are 
user logical record numbers. These are converted to system logical record numbers 
before being used by the DOS or placed into the LFT. 

After each record access (READS or WRITES), LRN is incremented. Thus, for sequential 
accesses, the user does not actually specify which record he is dealing with. However, a 
routine exists which allows the LRN to be changed to any value between zero and the upper 
limit on the file, providing a random access facility. (This upper limit depends upon the DOS 
in use). Note that, since no end of file mark is intrinsic to the system, the user must provide 
his own special data record to denote an end of file during sequential accesses. 

If a user wishes the option of processing his files using the standard DOS utility 
programs (SAPP, LIST, REFORMAT, etc.) then his EOFmark should follow DOS EDITOR 
conventions: 
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1) The first six user data bytes in the EOFmark sector are 

binary zeros. 

2) The seventh user data byte in the EOFmark sector is a 

binary three. 

For example: Assume the user has moved the last data record to be written to 
the appropriate disk buffer. (The terminating 03 is assumed to be there also). The 
following sequence will write the final record and create a valid DOS EOFmark: 





LB 


LFn 




CALL 


WRITES 




LC 


6 


EOFPUT 


XRA 






CALL 


PUTS 




LA 


-1 




ADC 






LCA 






JFZ 


EOFPUT 




LA 


3 




CALL 


PUTS 




CALL 


WRITES 




CALL 


CLOSES 


5.6.1 PREP$ - 


opon or 


create a 



Specify output LFN 
Write last data record 
Loop counter 
Set A to binary zero 
Output zero to buffer 
Decrement counter 



And repeat as needed 
Set A to binary three 
Last byte of EOFmark 
Write the EOFmark 
And close the file 



PREPS searches the directory or directories specified for the given name. If the 
name is found, the file is simply opened for use as the specified logical file number. 
Otherwise, a new file having the name specified will be created. If a new file is 
created, an end of file by GEDIT convention (six zeros followed by an 003) is written 
in logical record zero. Whether the file is simply opened or is created, the information 
describing it is stored in the LFT entry specified so that all subsequent references to 
that file by its LFN will be able to deal with the correct locations on the disk. If the 
LFT entry specified is already in use when PREPS is called, the file that the entry 
specifies will be closed (see Section 5.6.5) and then the new file opened in its place. 

DE is normally an address of an 11 -byte string which is the name of the file 
being specified (as explained before under Section 5.1). However, if the D register is 
zero then the E register contains the physical file number. The ability to reference 
files by number makes it possible to avoid the substantial time required to search the 
directory for a name. If the PFN is already in use, a 'SPACE' trap will occur. 
Otherwise, the file of that number will be created. When a file is created by number, 
its name in the directory consists of all 0377 characters, preventing it from being 
accessed symbolically or being listed by the catalog listing command. When a PFN 
is supplied, a particular drive must be specified (0377 may not be specified as a drive 
number). 
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Entry point: 



Parameters; 



Exit condition; 



Traps: 



01063 

B =LFN (16,32,48; =>nop) 
C =Drive Number or 0377 
DE=^Name or D=-0 and E=PFN 

If PFN given, C must not be 0377. 

B =LFN; other registers indeterminate 

SPACE if a new file must be allocated and no space 

is left, no more directory entries are available, 
or the drive specified is off line. 



5.6.2 OPENS - open an existing file 



OPENS is similar to PREP$ except for the action taken if the file specified does 
not exist. In this case, return is made with the Carry condition true (return is made 
with it false if the file exists). Action is similar if a PFN is supplied instead of the 
name. If the PFN specified exists, the file is opened and return is made with the 
Carry condition false. Otherwise, return is made with the Carry condition true. 



Entry point: 
Parameters: 
Exit conditions: 



01066 



same as for PREP$ 



B =LFN; other registers indeterminate 
Carry true if the file is non-existent 



Traps: none 

5.6.3 LOAD$ - load a file 

LOADS opens the specified file as logical file zero and then calls the system 
loader to load it into memory. Exit is made with the Carry condition set if the file is 
non-existent. If the load is successful, return is made with the starting address in the 
H and L registers. 



Entry point: 
Parameters: 
Exit conditions: 

Traps: 



01071 

same as for PREPS (except B not required) 

B =LFN (always zero) 

HL ^starting address if good load 

Carry true if file non-existent 

OFFLIN drive off line 

RPARIT file contains parity fault 

RANGE loader ran off end of file 
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FORMAT record of bad loader format 



5.6.4 RUNS - load and run a fito 

RUNS opens the specified file as logical file zero and then calls the system 
loader to load it into memory. Return is made to following the call if the name 
specified cannot be found in the directory or directories specified. If any loading 
errors occur, the operating system is reloaded. Otherwise, control is transferred to 
the starting address given by the loader. 

Entry point. 01074 

Parameters: same as for PREP$ 

(except that B is not required) 

Exit conditions: returns if name not in directory 

operating system reloaded if bad load 
otherwise, control is passed to the 
starting address of the new file. 

Traps: none 



5.6.5 CLOSES - close a file 

When new space is allocated for a file, a large contiguous piece (up to one full 
segment) is taken in an effort to keep the file as physically contiguous as possible. 
When this allocation takes place, a flag in the LFT, called the new space allocated 
flag is set.' The LFT also contains a number which is the largest LRN referenced 
while the file was open. When CLOSES is called, the file is physically truncated after 
the largest LRN referenced, if the new space allocated flag is set. Thus, if only a 
few records of the new space allocated has been used, the rest of the space is freed 
for use in other files. However, if all of the space is used, the file will consist of a 
large amount of physically contiguous space. Note that if CHOPS was called with the 
D register negative, and the LRN in the LFT has not been changed, a call to CLOSES 
will delete the entire file and remove its entry from the directory. 

After the file has been truncated, if necessary, CLOSES then writes the copies 
of the protection bits and old file length limit field that are in LFT entry back into the 
directory. Therefore, one only needs to change these entries in the LFT and then 
close the file to have them changed in the directory. This is the basis for the 
functioning of the CHOPS and PROTES routines. Since the protection bits and old 
file length limit field are not changed on the disk until the CLOSES routine is called, 
if one changes these numbers and then, for some reason, reloads the system without 
calling the CLOSES routine (by depressing RESTART before the file is closed, for 
example) the disk will retain the old values. 
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After the protection and file length limit have been stored in the directory, 
CLOSES then vacates the LFT entry specified. This is achieved by storing an 0377 in 
the second byte of the entry (this is the drive number and 0377 denotes that the LFT 
entry is not m use). CLOSES simply returns if the LFT entry is not in use. 



Entry point: 



01077 



Parameters: 



B =LFN 



Exit conditions: 
Traps: 



B =LFN; other registers indeterminate 



none 



5.6.6 CHOPS - delete space in a file 

CHOPS sets the maximum LRN value kept in the LFT and sets the new space 
allocated flag if no protection is set. If the CLOSES routine is called after the call to 
CHOPS without the LRN being changed, the space after the specified LRN will be 
physically deleted from the file, making It free again for alJocation by the system. 
Note that if the D register is negative upon entry to CHOPS, calling the CLOSES 
routine will completely delete the file from the system (removing its entry from the 
directory as well as freeing all of its space). When an entry is deleted from the 
directory, all 'sixteen bytes of the directory for that entry are set to 0377. This is the 
same value for an unused directory entry that is set by the system generation 
program. 

CHOPS changes the MAXLRN field in the LFT to the LRN supplied as the 
parameter. (Note: CHOPS makes provision here for the two RIBs and biases the 
LRN supplied by the user by two before placing it into the LFT MAXLRN field). 
Remember that calling CHOPS only affects the LFT entry and that no physical 
change on the file is effected until CLOSES is called. 



Entry point: 
Parameters: 

Exit conditions: 
Traps: 



01102 

B =LFN 

DE =LRN if D not less than zero 

DE <0 to delete entire file 

B =LFN; other registers indeterminate 

RANGE DE not less than MAXLRN 

DVIOLA delete protection is set 

WVIOLA write protection is set 
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5.6.7 PROTE$ - change the protection on a file 

PROTE$ changes the file protection bit and/or upper file length limit copies that 
are kept in the LFT. The protection bits, given in the C register, are changed only if 
the least significant bit of the C register is a one. The old upper file length limit 
field is changed only if the sign bit of D is one on entry. Therefore, setting the 
number to zero prevents the limit field from being changed. Note that the file length 
field is obsolete and is no longer used by the DOS; it is maintained for future use, 
probably as a file type designation field. 

Entry point: 01105 

Parameters: B =LFN 

C =new protection: 

GO =1 for protection change 
C6 =1 for write protection 
C7 =1 for delete protection 

DE =new LRN limit field; for no change 

Exit conditions: B =LFN; other registers indeterminate 

Traps: none 

5.6.8 POSIT! - petition to a record within a file 

POSITS positions the file logically and the head physically to the LRN given. If 
the LRN given is negative, the current value in the LFT is used for positioning the 
head and the LFT entry is not changed. Note that positioning to record zero 
performs a logical rewind' of sequential files. 

Entry point: 01110 

Parameters: B =LFN 

DE =LRN (use LRN from LFT if D <0) 

Exit conditions: B =LFN 

D =Physical Disk Address (MSB) 
E =Physical Disk Address (LSB) 
other registers indeterminate 

Traps: RANGE LRN <0 or LRN >file limit 
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5.6.9 READS - read a record into the buffer 

READS causes the record, pointed to by the LRN in the LFT entry specified by 
the LFN given, to be transferred from the disk to the disk controller buffer that 
corresponds to the LFN given. The LRN is incremented by one after the read if it 
was successful. READS tries four times to read a record, if a parity fault is detected, 
before giving the trap. Attempting to read a record that is not physically allocated 
will cause the 'RANGE' trap. 



Entry point; 



01113 



Parameters: 



B =LFN 



Exit conditions: B =LFN; other registers indeterminate 

Traps: RANGE LRN out of range 

RPARIT record unreadable 

FORMAT PFN or LRN in record incorrect 

OFFLIN drive off line 

5.6.10 WRITES - write a record from the buffer 

WRITES first takes the PFN and LRN values from the LFT entry specified by the 
LFN given and stores them into the first three bytes of the disk controller buffer that 
corresponds to the LFN given. It then transfers that buffer to the sector on the disk 
specified by the LRN in the LFT entry specified by the LFN given. The LRN is 
incremented after the write if it is successful. Note that all system routines use DWS 
in writing records and hence try up to four times to obtain a good write, if a parity 
fault is detected, before giving the trap. 

If WRITES tries to write a record which would not go in a place that has been 
physically allocated, it will automatically try to allocate more space. If the space is 
available, it is allocated and the write occurs. If there is no more physical space on 
the disk or if there are no more entries in the RIB available for the new segment 
descriptor, a 'SPACE' trap is given. 



Entry point: 



01116 



Parameters: 



B =LFN 



Exit conditions: 



B =LFN; other registers indeterminate 
LRN =LRN + 1 



Traps: 



WVIOLA file is write protected 

WPARIT write/verify failure 

OFFLII^ drive off line 
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RANGE LRN <0 

SPACE explained above 



5.6.11 QET$ - get the next buffer character 

The LFT contains an entry called BUFADR (not to be confused with loc. 026 
used by GETNCH) which points to a character In the disk controller buffer that 
corresponds to the given LFN. Each buffer contains 256 characters but since the 
system uses the first three bytes in each sector to store the PFN and the LRN of 
each record, the user has only 253 bytes available. 

Whenever READS, WRITES, or POSITS are executed, they set the buffer pointer 
mentioned above to point to the third byte in the disk controller buffer associated with 
the given LFN (by setting the BUFADR field of the LFT entry to a three). Whenever 
GETS is called, the byte pointed to by this pointer is fetched from the disk controller 
buffer and the pointer is incremented. If the byte being returned is not a valid user 
data byte (i.e. BUFADR was 0,1. or 2 on entry) then carry is true on return, and 
register A contains the specified byte of the buffer (which will be PFN or one of the 
LRN bytes.) Note that the next buffer is not read automatically from the disk; the 
pointer simply ends-around. Upon the first call of GETS which returns carry true, the 
PFN will be obtained since it is contained in buffer location zero. The first three 
bytes may also be accessed by simply setting the buffer pointer contained in the LFT 
entry to the desired location. 

Entry point: 01121 

Parameters. B =LFN 

Exit conditions: A =the byte obtained from the buffer 

All other registers preserved 
Carry true if location 0,1, or 2 accessed 

Traps: none 

5.6.12 QETR$ - get an Indexed buffer character 

GETRS is similar to GETS except that it uses the logical buffer address supplied 
in the C register instead of the physical buffer address in the LFT for the address of 
the disk buffer byte to return. Calling GETRS has no effect on the buffer pointer kept 
in the LFT. The physical buffer location is obtained by adding three to the value 
given in the C register to skip past the system data in the first three bytes in the 
disk buffer. Thus the user is presented with a logical space within a record that is 
addressed from through 252. Normally, GETRS exits with the value in the C 
register incremented by one and the carry condition false. However, if the C register 
is between 253 and 255 (inclusive) upon entry, it will not be incremented and exit will 
be made with the carry condition true. In either case, the buffer byte located by the 
C register value plus three is returned in the A register. Therefore, the user may 
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obtain any buffer byte with GETR$ but must remember to supply an address which is 
the physical buffer address minus three and remember not to assume that the C 
register will be incremented if he plans to access one of the first three phsical bytes. 



Entry point: 



01124 



Parameters: 



Exit conditions: 



Traps: 



B =LFN 

C =buffer location 

A =byte obtained 
C =C + 1 if carry false 
Carry true if 252 <C <256 
All other registers preserved 

none 



5.6.13 PUTS - store into the next buffer position 

PUTS is similar to GETS except hat the byte presented in the A register on 
entry is stored into the buffer. Also, on return register A contains the physical 
address of the next byte to be accessed in the disk buffer. Carry is true if the byte 
stored was stored into the last physical location in the buffer. Here a reminder is 
appropriate: remember that in standard, EDIT-format records, the last two bytes (at 
least) of the buffer are not used, and an 03 occurring earlier in the sector indicates 
logical-end-of-sector. (A complete description of the format for EDIT-copatible text 
files can be found in the REFORMAT command in Part III of this manual.) 



Entry point: 



01127 



Parameters: 



A =the byte to be stored in the buffer 
B =LFN 



Exit conditions: 



A as described above 

All other registers preserved 

Carry true if location 255 as stored into 



Traps: none 

5.6.14 PUTR$ - store into an indexed buffer position 

PUTRS is identical to GETRS except that the byte presented in the A register is 
stored into the buffer. 



Entry point: 
Parameters: 



01132 

A =byte to be written 

B =LFN 

C =logical buffer location 
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Exit conditions: C =C + 1 if carry false 

Carry true if 252 <C <256 
All other registers preserved 

Traps: none 

5.6.15 BSP$ - backspace one record 

BSP$ decrements the LRN in the LFT entry specified by the LFN given and then 
executes POSITS. If the decrementation caused the LRN to become less than zero, a 
'RANGE' trap is given. 

Entry point: 01135 

Parameters: B =LFN 

Exit conditions: B =LFN; other registers indeterminate 

Traps: RANGE LRN <0 after decrementation 

5.6.16 BLKTFR - transfer a block of memory 

BLKTFR moves the number of bytes specified in the C register (0 causes 
transfer of 256 bytes) from the memory location starting where HL points to the 
memory location starting where DE points. Note that since exit is made with HL and 
DE pointing after the last byte moved and C equal to zero, transfers of more than 256 
bytes may be made by first setting C to zero, calling BLKTFR enough times to make 
the residual number of bytes to transfer less than 256, setting C to the residual 
number of bytes to be transferred, and then calling BLKTFR one last time. For 
example: 



HL 


SOURCE 


DE 


DEST 


LC 





CALL 


BLKTFR 


CALL 


BLKTFR 


LC 


25 


CALL 


BLKTFR 



will cause 537 bytes to be transferred from SOURCE to DEST. 
Entry point: 01143 

Parameters: C =number of bytes to be moved 

(0 moves 256 bytes) 
HL =source address 
DE =destination address 
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Exit conditions: HL =HL + C (HL + 256 if C =0) 

DE =DE f C (DE + 256 if C =0) 
C =zero 

Traps: none 

5.6.17 TRAPS - set an error condition trap 

There are eight non-fatal error conditions, concerning the disk operating system 
file handling facilities, that may be trapped by the user. If the trap corresponding to 
a certain error is not set by this routine, the system displays a pertinent message and 
reloads the system. Otherwise, control is transferred to the address specified when 
the trap was set, with the subroutine return address stack in the state it had before 
the calling of the file handling routine that caused the error condition. 

The only disk errors that cannot be trapped are ones associated with the system 
tables on the disk. The occurrence of these errors causes the message 

FAILURE IN SYSTEM DATA 

to be displayed. The other errors that cannot be trapped have to do with: the LFT 
entry not being open when a routine which tried to use data from the entry was 
called, invalid logical file numbers, invalid drive numbers, invalid trap numbers, and 
invalid physical file numbers. 

If a trap occurs during a call to READS or WRITES, the logical record number 
(LRN) in the logical file table (LFT) is NOT incremented; if the user wishes to 
continue processing records past the one which caused the trap, he must increment 
the LRN in the LFT himself first. 

TRAPS sets the trap whose number is given In the C register to the address 
supplied in the D register (MSB) and E register (LSB). The trap is cleared by calling 
TRAPS with D and E equal to zero. The trap is also cleared when the error 
condition occurs, at which time the B register will be loaded with the Logical File 
Number in-volved and control transferred to the indicated address. 

In the following table, the mnemonic given after the trap number is the one 
used in the previous routine explanations. The capitalized lines are the messages 
displayed if the trap is not set. 

- RPARIT - PARITY FAILURE DURING READ 

A parity fault while reading a data record causes this trap. 

1 - WPARIT - PARITY FAILURE DURING WRITE 

A parity fault while writing a data record causes this trap. 

2 - FORMAT - RECORD FORMAT ERROR 

The physical file number or logical record number in the record read not 



SECTION 5. SYSTEM ROUTINES 5-17 



matching the ones contained in the logical file table entry causes this 
trap. The physical position of a record is obtained from information in the 
retrieval information block and the PFN and LRN in the record are only 
checked to ensure that the drive is functioning correctly and that the user 
is not trying to read a record he has not written. This trap has nothing 
to do with the 253 data bytes provided to the user. 

3 - RANGE - RECORD NUMBER OUT OF RANGE 

During a read, an access below zero or to a record above the currently 
allocated space causes this trap. During a write, an access below zero 
causes this trap. 

4 - WVIOLA - WRITE PROTECT VIOLATION 

An attempt to write on. delete, or shorten a file with the write protection 
bit set causes this trap. 

5 - DVIOLA - DELETE PROTECT VIOLATION 

An attempt to delete or shorten a file with the delete protection bit set 
causes this trap. 

6 - SPACE - FILE SPACE FULL 

An attempt to allocate more space when either the disk is full or no more 
segment descriptor slots in the RIB are available causes this trap. 

7 - OFFLIN - DRIVE OFF LINE 

An attempt to use a drive that is either physically absent or not online 

causes this trap. 

Note that the causes given for the various traps are the causes for DOS to 
issue the appropriate messages. Some of the DOS Command programs also cause 
the issuance of some of these messages for related reasons. For example, several 
DOS Utilities indicate a RECORD FORMAT ERROR if the sector formatting of a file 
being processed does not follow GEDIT (or DOS EDITOR) standards. In cases such 
as this the above details are sometimes not valid descriptions of the problem; here 
the 253 data bytes encountered may have everything to do with the cause of the 
record format error. 

Note also that FORMAT and RANGE traps are frequently the result of 
sequentially reading or otherwise processing a file which has no valid EOFmark, 
resulting in the program running off the logical end of the file. 



Entry point: 01146 

Parameters: DE =trap address 

C =trap number 

Exit conditions: register contents indeterminate 
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Traps: 



none 



5.6.18 EXITS - reload the operating system 



EXITS closes any logical files (one through three) that are open and then 
reloads the operating system. EXITS is the normal exit for all DOS programs. If 
drive zero is off line when EXITS is reached (or if the DOS is unloadable from there 
for any reason) an automatic drive switch occurs (indicated by a beep) and an 
attempt is made to load the DOS from the next drive in sequence. The automatic 
drive switch and beep is repeated until the DOS is successfully loaded. One jumps 
to this entry point. 



Entry point: 



01151 



Parameters: 



none 



Exit conditions: 



no exit 



Traps: 



none 



5.6.19 ERRORS » reload the operating system 

ERRORS is identical to EXITS in all respects except for the fact that jumping to 
ERRORS will abort an active CHAIN (refer to the CHAIN command in Part III of this 
manual for more details). A user program would exit through ERRORS if an error of 
severity suggesting aborting a CHAIN occurred. 



Entry point: 



01140 



Parameters; 



none 



Exit conditions: 
Traps: 



no exit 



none 



5.7 Keyboard and Display Routines 



5.7.1 DEBUGS - enter the debugging tool 

The debugging tool enables the programmer to load files by number, examine 
and modify memory locations, set break points, and execute sections of his program. 
This facility greatly simplifies the task of debugging machine language programs. 

The debugging tool can be entered from the command interpreter by entering a 
single pound sign (#) on the command line or from the user's program by jumping to 
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the entry point. When it is executing, two numbers are displayed vertically in the last 
column of the screen. The top number, consisting of five digits, is an address and 
the bottom number, consisting of three digits, is the content of that address. After 
these numbers are displayed, input is requested from the keyboard as indicated by a 
flashing cursor. Commands to the debugger are given in the form <n>X where 
<n>is any number of octal digits and X is a command character. 
The command is executed immediately upon depression of the command character 
key without waiting for the ENTER key (the ENTER character Is a command in Itself). 

All keys that are not recognized are ignored with a beep signaling the rejection. 
The BACKSPACE key is ignored but since commands use only the lower eight or 
sixteen bits of <n>, errors in the entry of numbers can be corrected by striking 
several zeros and then entering the correct digits. Alternatively, the CANCEL key 
causes the current input line to be erased without changing the current 
address. Although display stops if the cursor runs off the screen during input, 
characters are still accepted. 

The debugger maintains a current address that is usually displayed as the five 
digit number at the right of the screen. There are times, however, when the five 
digits at the right of the screen do not reflect the current address and caution must 
be exercised to avoid confusion as to the value of the current address. The ENTER 
key is normally used to change the current address, but depressing it without 
preceding it with any digits will cause the current address to be displayed. Therefore, 
if there is any doubt about the numt>er being displayed on the screen, simply 
depressing the ENTER key will ensure that the current address is being displayed. 

Whenever the debugger is entered either from the jump to the entry point or 
from a return from a break point or call command, a beep is given and the state of 
all of the alpha mode registers and condition flags is saved. The value initially 
displayed is the top of the stack at entry, unless DEBUG was entered from a DOS 
DEBUG breakpoint; in this case the address displayed Is the address where the 
breakpoint was set. In all cases, the stack is preserved as at entry and the current 
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the state of his program when the debugger was entered. Whenever a memory 
location is called or jumped to, the state of all of the alpha mode registers and 
condition flags is restored from the values saved at entry. Since these values are 
saved In memory, the programmer can simply modify these locations to change the 
values used to initialize the state of the alpha machine before control is transferred. 

The major debugging technique is the setting of break points at critical places 
in the program and the execution of portions of the program while checking the 
values of the registers and critical memory locations at each break. The debugger 
sets a break point by storing a jump instruction, to a special entry point in itself, in 
the current address and the following two locations. (Notice that setting break 
points less than three bytes apart is therefore not a good idea.) Before the jump is 
stored, the content of the memory locations to be used Is saved in a table in the 
debugger. When the break point is reached, the memory locations are restored with 
their original contents. A maximum of four break points may be active at any one 
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time. A command is provided for insuring that all break points have been restored. 
When a break point is executed, the current address is set to the first byte of the 
break point jump instruction. Since the J command causes a jump to the current 
address if no digits precede It, one can continue execution of the routine that was 
broken by simply depressing the J key. Execution will continue with the first byte 
that was overstored by the break point jump with the state of the alpha machine 
exactly like it was before the break occurred. Thus, the programmer can set a break 
point, start execution, examine the registers when the break occurs (since register 
viewing does not change the current address) and then depress the J key to continue 
execution. This technique allows him to practically single step his program. 

ENTRY POINT: 01154 

COMMANDS: 

B - Set a break point at the location given or, if no number is given, at the current 
address. Caution should be exercised to insure that the current address is 
pointing to the desired location if it is used. 

C - Execute a call to the number given or, if no number is given, to the current 
address. The alpha machine state is loaded from the values saved in the 
debugger before the call is executed. A return to the call causes the debugger 
to be re-entered and the alpha machine state to be saved. 

D - Decrement the current address (any digits given are ignored). 

G - Get the physical file specified from the disk. Care must be exercised that a file 
is not loaded that will overlay the debugger (locations p-01377 and 06000-07377). 
If the file does not exist or contains a record of illegal loader format, a beep 
will be given. The first digit of the last four entered is the logical drive number 
from which the file is to be loaded. The following three digits are the physical 
file number. For example, 02003G will load SYSTEM3/SYS from drive two. To 
load PFN 0115 from drive 0, simply enter 115G. 

I - Increment the current address (any digits given are ignored). 

J - Execute a jump to the number given or, if no number is given, to the current 
address. The alpha machine state is loaded from the values saved in the 
debugger before the jump is executed. 

M - Modify the contents of the current address. The least significant eight bits of the 
octal number given before the command character are used for the new memory 
value. If no digits are given, a zero is assumed. 

P - Turn on the P-counter display (to the left of the current address). This display is 
a foreground driven routine which takes the value of the P-counter when the 
interrupt occurred and displays it vertically. This implies that the value shown 
is the background P-counter at 32 millisecond sample points. When the display 
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is active, simultaneous depression of the KEYBOARD and DISPLAY keys will 
cause the debugger to be entered regardless of what is currently being 
executed in the background. When such entry occurs, the current address 
points to the location where the background program was interrupted so that 
execution can be resumed with the J command. 

R - Display the saved alpha mode register value. The registers are referenced by 

number tO-A, 1-B, 2-C, 3-D. 4-E, 5-H, 6-L, and 7-Conditions). The condition code 
is stored with bits 7=Carry, 6=Slgn, bits 5 through 2 always zero, 1=(-Zero and 
-Sign), and 0=(-Zero and -Parity). (The easiest way to understand this is to 
realize that the condition code as displayed, added to Itself, results in restoring 
all four conditions to their entry values.) When a register is displayed, the 
address shown is the memory location used to store the value of that register. 
This does not, however, affect the current address. The registers may be 
initialized for a C or J command by simply storing into the memory locations 
displayed when the registers are displayed. 

X - Turn off the P-counter display 

#- Clear all break points. The current address will reflect the location of the last 
point cleared. 

. - Perform the M command followed by the I command. 

CANCEL - Erase the entered number without changing the current address. 

ENTER - Change the current address to the digits entered. If no digits are entered, 
the current address in effect will be displayed. 

5.7.2 KEYIN$ • obtain a Una from tho koyt>oard 

KEYIN$ obtains a string of characters from the keyboard, displaying them on the 
screen and storing them In memory as they are entered. Its operation is Identical to 
the KEYIN$ routine contained In the Cassette Tape Operating System. When KEYIN$ 
is called, the cursor is turned on and characters requested. Backspacing off the 
beginning of the line, entering more than the specified maximum number of 
characters, or running off the screen is prevented. The routine turns off the cursor 
and returns when the ENTER key is depressed. 

Entry point: 01157 

Parameters: C i=maximum number of characters accepted 

D =lnitlal horizontal cursor position 
E =vertlcal cursor position 
HL =startlng location of input buffer 

Exit conditions: String terminated by 015 

HL pointing to the 015 
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D =horizontal position of ENTER 
E ^unchanged 

5.7.3 DSPLY$ - display a line on the screen 



DSPLY$ displays a string of characters stored in memory on the screen. 
Certain characters denote control functions according to the following table: 

003 - end of string 
011 - new horizontal position follows 
013 - new vertical position follows 
015 - end of string with CR/LF 

021 - erase to end of frame 

022 - erase to end of line 

023 - roll up one line 

This routine is identical in function to the DSPLY$ routine in the Cassette Tape 
Operating System. If the string to be displayed starts with either or both horizontal or 
vertical cursor controls, then either or both of the corresponding values need not be 
in D or E at entry. 

Entry point: 01162 

Parameters: D =initial horizontal cursor position 

E =initial vertical cursor position 
HL points to string in memory 

Exit conditions: DE =cursor position after the last 

character displayed 
HL =byte after the string terminator 

5.8 DOS FUNCTION Facility 

The page of memory located between 07400 and 07777 contains a special 
loader and overlay area. This 'loader' can load any one of up to 255 DOS overlays, 
each up to 124 bytes long. The loader resides in the first half of the page and the 
overlays all load into the second half of the same page. The overlays reside on disk 
in physical file 7, called SYSTEM7/SYS. The design of the DOS FUNCTION loader is 
such that overlays are loaded only if necessary; i.e. if the same overlay is called 
several times in sequence, it is not reloaded each time. The overlays provide the 
DOS assembly language programmer with many useful utility functions. New DOS 
FUNCTIONS will be added from time to time as they are implemented; DOS 
FUNCTIONS are distributed on the DOS UTILITIES tape. Parameterization of DOS 
FUNCTIONS varies with the individual functions, the only basic requirement being that 
on entry to the DOS FUNCTION loader, the A register contains the function number 
(1-255). Use of functions not yet Installed will produce indeterminate results, but may 
result in format traps, range traps, processor halts, and the like. DOS FUNCTIONS 
are normally loaded from the SYSTEM7/SYS on drive zero. 
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Upon the first call to DOSFNC (the DOS FUNCTION loader), SYSTEM7/SYS Is 
opened as LFO and the LFT entry saved internally to the DOS FUNCTION loader. 
Upon subsequent calls to DOSFNC, the entry is simply moved back into the LFT, 
eliminating the need to re-open SVSTEM7/SYS each time a function is loaded. The 
file is only closed by the reloading of the DOS, either by depressing RESTART or by 
a program passing control to BOOTS, EXITS, or ERRORS. 

Since new DOS functions will be release frequently, the following descriptions 
should not be considered exhaustive. 

Entry point: 07400 

Parameters: A =Function number (1-0377) 

Others required by individual functions 

Exit conditions: Defined separately for each function 
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DOS FUNCTION: 1 
subfunction selector 

uniform attributes for all subfunctions: 
on entry, A =function number (1) ' 

C =subfunction number (0,1,2,3,4,5,6) 
on exit, B.C.H.L all unchanged 

CARRY FALSE: function completed successfully 

CARRY TRUE: invalid subfunction number 

all other entry/exit parameters and conditions are described separately for each 
individual subfunction. 



DOS FUNCTION: 1 SUBFUNCTION: 

return the address of a specified directory sector in DE 

on entry, B =directory sector number (0-15) OR 

PFN of entry in the directory sector 
on exit, A indeterminate 

DE =PDA of specified directory sector 



DOS FUNCTION: 1 SUBFUNCTION: 1 

return the two byte physical disk address for each of the 16 prime directory 
sectors, into a 32-byte work area provided by the user. 

on entry, HL ==> 32-byte work area to receive the PDAs 

on exit, all registers restored 

user-provided work area contains 16 PDAs, one corresponding to 
each prime directory sector, in ascending order. 



DOS FUNCTION: 1 SUBFUNCTION: 2 

return the two-byte physical disk address of each of the 16 directory sector 
backups, in ascending order, into a 32-byte user-provided work area. 

on entry, HL => 32-byte area to receive the 16 PDAs 

on exit, all registers restored 

work area contains 16 PDAs (LSB,MSB) 



DOS FUNCTION: 1 SUBFUNCTION: 3 

return the physical disk address of the prime cluster allocation table (CAT) in the 
DE register pair. 

on exit, A indeterminate 

DE =PDA of prime CAT 
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DOS FUNCTION: 1 SUBFUNCTION: 4 

return the physical disk address of the backup CAT 

on exit, A indeterminate 

DE =PDA of backup CAT 



DOS FUNCTION: 1 SUBFUNCTION: 5 

return the physical disk address of the lockout CAT 

on exit, A indeterminate 

DE =PDA of lockout CAT 



DOS FUNCTION: 1 SUBFUNCTION: 6 

return the physical disk address of the lockout CAT backup 

on exit, A indeterminate 

DE =PDA of lockout CAT backup 



DOS FUNCTION: 1 SUBFUNCTION: 7 

return the address of a backup directory sector (in DE) 

on entry, B =backup directory sector number (0-15) OR 

PFN of a file entry contained therein 
on exit, A indeterminate 

DE =PDA of backup directory sector 
DOS FUNCTION: 2 
subfunction selector 

Uniform attributes for all subfunctlons: 
on entry, A. =funct!on number (2) 

C =subfunctlon number (0,1,2) 
on exit, ALL REGISTERS RESTORED 

CARRY TRUE Implies error or invalid subfunction 

numt)er 

all other entry/exit parameters and conditions are described separately for each 
individual subfunction. 



DOS FUNCTION: 2 SUBFUNCTION: 

read in the directory sector containing the 16-byte directory entry corresponding to 
the PFN given, on a specified logical drive. 

on entry, D =PDN (logical drive number of file) 

E =PFN 
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B =LFN as per DOS standard; (0, 16, 32, 48) 
on exit, CARRY FALSE: selected directory sector is in buffer specified, 

which is the selected buffer upon exit. 
CARRY TRUE: indicates I/O error. 
Further defined as follows: 
ZERO FALSE: specified drive is off-line 

ZERO TRUE: unable to read sector due to CROC error during 
read, or unrecoverable failure to find sector 



DOS FUNCTION: 2 SUBFUNCTION: 1 

get 16-byte directory entry corresponding to a specified PFN on a given logical 
drive. 



on entry, B,D,E set as for subfunction 0. 

HL =>16 byte area to receive the entry 
on exit, CARRY FALSE: entry is in user's area. 

CARRY TRUE: as for subfunction 0. 



DOS FUNCTION: 2 SUBFUNCTON: 2 

get name/ext (pfn) for a specified numbered file on a specified logical drive. 
(Same basic format as used by DOS CAT command). 

on entry, B,D,E as for subfunction 0. 

HL =>20-byte receiving field, 
on exit, CARRY FALSE: user's 20-byte area contains the name, extension 

and PFN of the specified file, for example: 

EDIT/CMD (037) 
where the right paren is followed by an 03 
UNLESS: ZERO TRUE: implies that the file number specified 
does not exist, or was created by number and therefore has no 
name. 
CARRY TRUE: as for subfunction 0. 

NOTICE: the use of THIS SUBFUNCTION ONLY (of those in DOS FUNCTION 2) 
requires that the DOS command interpreter be present (the 
command interpreter resides from 013400-017000). 

5.9 Cassette Handling Routines 

Standard record formats, identifies, and file marker record conventions on 
cassettes are established by the Cassette Tape Operating System. Routines capable 
of dealing with cassettes in a manner compatible with CTOS are provided as part of 
the Disk Operating System to enhance its overall capability. For detailed information 
on cassette format and organization, see the Cassette Tape Operating System Manual. 

All of the DOS cassette routines are foreground driven and, with the debugging 
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facility, are the only routines within the system which make use of the foreground 
handling facility. Being foreground driven, however, does not alter the way with 
which the routines are dealt since all interfacing between the background and 
foreground is handled by the system. It does allow increased speed of operation with 
the cassettes since the user may be processing one record while the next is being 
read from or written to the tape. This is evident in the way the DOS slews the tape 
when transferring information between it and the disk. 

Some of the cassette handling routines initiate foreground action and then 
return immediately to the user while others wait for I/O completion. All of the 
routines wait for any uncompleted I/O to finish before starting something new. Note 
that in the cases of reading or writing on the same deck, requesting the next 
operation before the completion of the first will cause the tape to automatically slew 
instead of stopping between records. This is only in the case of a read followed by 
another read or a write followed by another write on the same deck. The only cases 
where caution must be exercised is in the read and write routines which return 
immediately after starting the I/O operation. If the user does not wait for the transfer 
to complete, he could try to use the data before it is read or change the data before 
it is written. In the second case, records with incorrect parity will usually be 
generated. Routines are provided, however, which automatically wait for the transfer 
to complete, relieving the user of having to concern himself with the fact that the 
routines are foreground driven if he has no need for the advantages. 

The various error conditions associated with cassette handling can be trapped 
by the user. If the trap is not set, an error message similar to the error message 
generated by CTOS is displayed and the DOS reloaded. If the trap has been set, the 
address specified will be jumped to and the trap cleared. The traps are identified in 
the error message by a letter similar to the CTOS identification. In the relevant 
cases, the same letter is used in the DOS as is used in the CTOS. In the following 
routine descriptions the relevant letter will be given in the Traps' section. 

Most of the cassette routines are parameterized by a deck number given in the 
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5.9.1 TPBOF$ - position to the beginning of a file 

TPBOFS positions the cassette in the specified deck to the specified file. The 
search for the file marker of the desired file is started with backward motion of the 
tape. If a marker of lower value than the file number requested or the beginning of 
the tape is encountered, the search willbe reversed to the forward motion of the 
tape. If then a marker of larger value than the file number requested, the end of the 
tape, or a record of unrecognizable format is encountered, an error G will be given. 
Otherwise, the file is left positioned before the first data record. 

Entry point; 010000 

Parameters: B =deck number 

C =physical file number (0-0177) 
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Exit conditions: none 



Traps: 



D unrecognizable record found 
G file could not be found 



5.9.2 TPEOF$ - position to the end of a file 

TPEOFS moves the tape forward until the next file mark is found. It then 
backspaces the tape one record to leave it at the end of the current file. 



Entry point: 
Parameters: 
Exit conditions: 
Traps: 



010005 

B =deck number 

none 

D unrecognizable record found 
E end of tape encountered 



5.9.3 TRW$ - physically rewind a cassette 

TRW$ rewinds the cassette on the selected deck by first slewing backwards to 
ensure that the tape is not on the trailer and then performing a hardware rewind. 



Entry point: 
Parameters: 
Exit conditions: 
Traps: 



010012 

B =deck number 

none 

none 



5.9.4 TBSP$ - physically backspace one record 

TBSP$ simply executes a hardware backspace function. No checking is 
performed on the data passed over. However, backspacing onto clear leader causes 
an end of tape trap. 



Entry point: 
Parameters: 
Exit conditions: 
Traps: 



010017 

B =deck number 

none 

E beginning of tape encountered 
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5.9.5 TWBLK$ - write an unformatted block 

TWBLK$ writes the specified number of bytes (0-255; causes 256 to be 
written) from the memory buffer specified onto the cassette in the deck specified. 
Only the bytes specified will be written on the tape. 



Entry point: 



010024 



Parameters: 



B =deck number 

C =number of bytes to write (0 for 256) 

ML points to start of buffer 



Exit conditions: 



none 



Traps: 



E end of tape encountered 
Z premature deck ready status 



5.9.6 TR$ - read a numeric CTOS record 



TR$ reads a record of CTOS numeric format into the memory locations 
specified. The length of the record is stored in the specified memory location and the 
data bytes are stored in the locations that follow. Return is made from TR$ as soon 
as the read operation is started but the user cannot use thedata until the operation 
has been completed (see TCHK$). One way to check for operation completion is to 
call TR$ again with a different buffer as its parameter. Return from the second call 
will be made as soon as the first operation is completed. This is the mechanism via 
which multiple buffering is normally achieved. Note that tape motion will not cease if 
TR$ is called within five milliseconds of the end of the previous record. 

If parity problems arise, TR$ tries up to 5 times to read the tape before giving a 
parity failure trap. Other traps given are end of tape an end of file, if an end of 
file trap is given, the tape is positioned before the file marker. 



Entry point: 



010031 



Parameters: 



B =deck number 

HL points to data storage location 



exit conditions: 



none 



Traps: 



D parity failure 

E end of tape encountred 

F end of file encountered 
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5.9.7 TREADS - TR$ and wait for the last character 

TREADS performs the TR$ function and then waits for the last character to be 
read from the tape. This routine should be used when multiple buffeing is not being 
performed since it relieves the user from having to explicitly wait for the last 
character to be read. 



Entry point: 
Parameters: 
Exit conditions; 



010034 

same as for TR$ 

none 



Traps: same as for TR$ 

5.9.8 TW$ - write a numeric CTOS record 

TW$ rites the specified memory locations in a record of standard CTOS 
numeric format. It uses (for parity generation) the three locations preceeding the 
memory location specified which contains the number of bytes to be written and is 
followed by that number of data bytes. 

TW$ returns as soon as the writeoperation is started. The user must be 
careful not to change any of the memory locations given as parameters before the 
last byte has been transferred. This can be achieved by either calling TCHK$ and 
waiting for completion status or calling TW$ with the next buffer if multiple buffering 
is being used. Note that tape motion will not cease if TW$ is called before the 
middle of the IRG is reached from the previous write (140 milliseconds after the last 
character is written when using a 7.5 ips deck). 



Entry point: 010037 



Parameters: 



Exit conditions: 



same as for TR$ 



none 



end of tape encountered 
premature deck ready status 



Traps: E 

Z 

5.9.9 TWRIT$ - TW$ and wait for the last character 



TWRITS executes the TW$ routine and then waits for the last byte to be written 
on the tape. This routine should be used when multiple buffering is not being 
performed since it relieves the user from having to explicitly wait for the last byte to 
be written. 
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5.9.10 TFMR$ - read the n«xt file marker record 

TFMR$ reads the tape until a file marker record is found. . A trap occurs if a 
record is encountered that is neither a file marker nor a CTOS numeric dta record. 



Entry point: 
Parameters: 



010045 



B =deck number 



Exit conditions: 



C =PFN of marker found 

Tape positioned after marker record 



Traps: D unrecognizable record found 

BTWVE end of tape encountered 

5.9.11 TFMW$ - write a file marlcer record 



TFMW$ writes a file marker record that contains the numt)er specified. 
Entry point: 010050 



Parameters: 



B =deck number 

C =PFN to be written 



Exit conditions: 



none 



Traps: 



E end of tape encountered 
2 premature deck readystatus 



5.9.1 TTRAP$ - set an error condition trap 

TTRAP$ allows the user to trap the various errors associated with cassette I/O. 
If the trap is not set, an error message of the form 

♦♦♦ERROR X ON DECK Y *♦♦ 

will be displayed, where X is one of the letters shown below and Y is a 1 for the 
rear deck and a 2 for the front deck. The trap is specified by a number according to 
the following table: 

3-D - parity error 

4 - E - end of tape 

5 - F - end of file 

6 - G - unfindable file 

In addition, error Z (cannot be trapped) indicatesthat the deck ray status bit came 
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mean 



when 



true while a record was being written. This implies that the write routine fll behind 
in wrting characters and most probably indicates that the foreground interrupt 
handling was disrupted in some fashion (interrupts were disabled too long or an 
interrupt driven routine was running which imposed too much overhead). 

Traps can be cleared by setting their addresses to zero. When the event which 
causes a trap occurs, that trap is cleared and control passed to the address indicated 
with the deck number in the B register (0 for rear and 1 for front deck). 

Entry point: 010053 

Parameters: C =trap number (above) 

DE=trap address (0 clears trap) 

Exit conditions: none 

Traps: none 

5.9.13 TWAIT$ - wait for I/O completion 

TWAIT$ waits for any tape operation active to complete. This does not 
that physical motion has stopped since TR$ and TW$ indicate I/O completion 



THE LAST CHARACTER HAS BEEN TRANSFERRED. It does mean that all data 
is free to be 

processed by the user. TWAIT$ also executes any traps pending upon the 
completion 

status being set. 

Entry point: 010056 

Parameters: none 

Exit conditions: B, C, D, and E registers preserved 

Traps: any trap pending will be executed 

5.9.14 TCHK$ - get I/O status 

TCHK$ sets the tape demand flag in the carrycondition flag andloads the tape 
handling status in the A register. The handling status codes are as follows: 

000 - PBOF in progress 
002 - PEOF in progress 
004 - Rewind in progress 
006 - Record read in progress 
010 - Backspace in progress 
012 - File mark read in progress 
014 - Record write in progress 

377 - Normal completion 
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206 - Parity error 

210 - End of tape 

212 - End of file 

214 - File not found 

262 - Premature deck ready status 

Normal use of the cassette routines will not require the user to deal with these status 
codes or even use the TCHK$ routine. They are provided here to facilitate 
understanding the listing of the routines. 

Entry point: 010061 

Parameters: none 

Exit conditions: Carry condition =demand flag 

A =status code (above) 

Traps: none 

5.10 Command Itorpreter Routines 

This section deals with a series of user-available routines available within the 
command interpreter. Note that these routines are only available for use if the user 
program does not overlay the command interpreter, which resides in locations 
012400-016777. 

The first three of these entry points are really more like 'exit points', since they 
are places in the DOS to which uers may return in place of EXITS. The primary 
advantage to using them in place of EXITS is that none of these three entry points 
result in the DOS being reloaded, a process which takes significant time. Note that 
since they do not reload the DOS, programs which exit through DOS$. CMDAGN, or 
NXTCMD must not have overstored any part of the DOS; i.e. they should run 
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traps that the user may have set; therefore the user should clear any traps he has 
set before exiting in this manner. If this is not done, the system will most likely go 
astray upon the first subsequent occurrence of a trapped situation. 

Most of the other routines documented in this section are routines which are 
used by one or more of the DOS command programs supplied either on the DOS 
Generation or DOS Utilities tapes. Since these routines are pointed to by the 
command interpreter's entry point table and are used by some of the utility programs, 
they are documented here primarily for the sake of completeness; not to suggest that 
every DOS programmer will find them wonderfully useful for his particular application. 
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5.10.1 DOS$ - return to command interpreter 



DOS$ causes a program which has been AUTO'd to be executed If no 
programs are set for auto-execution, the DOS sign-on is displayed, files 1-3 are closed 
If necessary, and the familiar 'READY' message displayed. Not4 again that any traps 
set by the user program (e.g. via TRAP$) are not cleared unless the DOS is reloaded 
This implies that if a user program sets any of the traps and wishes to return via 
pOS$, NXTCMD. or CMDAGN, it must first clear any traps it has set to prevent the 
uOS from going astray. DOS$ is the normal starting point of the DOS when a 
bootstrap operation occurs. 



Entry point: 



013400 



none 



Parameters: 

Exit conditions: Does not return 

5.10.2 NXTCMD - return to command interpreter 

NXTCMD causes files 1-3 to be closed and displays the familiar DOS 'READY' 
message. 



Entry point: 
Parameters: 
Exit conditions: 



013403 

none 

Same as DOS$ 



5.10.3 CIMDAGN - return to command interpreter 



CMDAGN causes files 1-3 to be closed and displays a user-supplied message 
before returning to the command interpreter. 



Entry point: 
Parameters: 

Exit conditions: 



013406 

HL =address of DSPLY$-format string 
DE unused; string should position cursor 

same as DOS$ 

CHAIN (a DOS Utility) aborts if active 
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5.10.4 GETSYM - get the next symbol from MCR$ 

GETSYM causes the next seqential symbol in MCR$ to be scanned off and 
stored in an 8-byte field called SYMBOL located at 013472. The starting byte scanned 
in MCR$ is pointed to by INPTR, a byte at location 013455. (INPTR is the LSB of the 
current byte in MCR$.) The symbol must begin with an upper case alphabetic 
character (leading spaces are ignored) and following that may contain upper case 
alphabetic or numeric characters. The first illegal character encountere terminates 
the scan; the illegal, terminating character is stored for the user's inspection (at 
SYMBOL+8) and SYMBOL is padded on the right with spaces if necessary. If the 
symbol is longer than eight characters, the first eight only are used; remaining 
characters, through the terminator, are scanned but not stored. (The terminator is 
stored at SYMBOL+8 in any case.) On exit, INPTR points after the terminating 
character unless the terminator is an 015, in which case INPTR points to the 015. 



Entry point: 
Parameters: 



013411 



INPTR =>current byte in MORS, LSB 



Exit conditions: 



SYMBOL =8-byte symbol as described above 

A, SYMBOL+8 =terminator character 

INPTR =>byte after symbi terminator in MCR$ 

(except as noted above) 
All other registers indeterminate 



5.10.5 GETCH - get tlie next character from MCR$ 

GETCH obtains the next character from the Monitor Communiation Region 
(MCR$) and returns it in A. The address of the character to be returned is obtained 
by using the most significant byte of the address of MCR$ (which is contained within 

is true, A =015 and INPTR is not incremented (INPTR is never bumped past an 015); 
if zero is false, A is not an 015 and INPTR is incremented. 



Entry point: 
Parameters: 
Exit conditions: 



013414 

INPTR =LSB of ddress of byte (see above) 

A =character from MCR$ 

ZERO TRUE/FALSE as described above 

B =entry value of INPTR 



C,D,E unchanged 
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5.10.6 GETAEN - Get auto-«xecuta physical file number 

GETAEN returns the physical file number of the file (on logical drive zero) 
which IS set to be auto-executed by the DOS. 



Entry point: 



013417 



Parameters: 



Exit conditions: 



none 

Carry true if I/O error reading the cat 
otherwise, A =auto-execute PFN (O=none) 
Zero true if a-e PFN not set 
Zero false if A is valid a-e PFN 
All other registers indeterminate 



5.10.7 PUTAEN - set or clear a file to be auto-executed 



PUTAEN either sets or clears the auto-execute PFN stored in the CAT on the 
disk in logical drive zero. The change becomes effective upon the next time DOS is 
entered at DOS$, either by depressing the RESTART key, the auto-restart tab being 
punched out of the rear cassette and the processor halted, or jumping to EXITS, 
ERRORS, BOOTS, or DOS$. 



Entry point: 
Parameters: 
Exit conditions: 



013422 



A =PFN to be auto-executed (0 to clear) 

All registers indeterminate 

Carry true if I/O error updating CAT 



5.10.8 GETLF1 - Open the user-specified data file 

GETLF1 opens logical file 1 using the file name, extension, and drive select 
code stored in LFT entry one in the normalized form described in Section 3.5. The 
extension, if blank, is assumed to be 'ABS'. Note: The logical drive specification 
field is ignored, since the drive select code field is used instead. If an error occurs, 
carry is true on return and HL points to a DSPLYS format string complete with cursor 
positioning ytes and one of the following messages: 

NAME REQUIRED, (first byte of name field is blank) 

INVALID DEVICE, (select code =0376; :DRn wrong) 

NO SUCH NAME, (file not found; the file must exist) 

Each of the abovemessages is proceeded bycontrol 
bytes: 011,0,013,11,023 and followed by an 015. Ifcarry is false upon return, the file 
named has been successfully opened as logical file one. 
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Entry point: 
Parameters: 
Exit conditions: 



013425 

In LFT entry one (of 0-3); see above 

Carry false if LF1 successflly opened 

Carry true and HL => message if OPEN failed 

All registers indeterminate 



5.10.9 PUTCHX - Store the character in 'A' 

PUTCHX stores the A register at the memory location pointed to by HL, 
increments HL, and decrements a byte counter maintained in E. 



Entry point: 
Parameters: 

Exit conditions: 



013433 

A =byte to be stored at HL 

E =count to be decremented 

HL = address where A Is to be stored 

B,C,D unchanged 
HL =entry value + 1 
E =entryvalue - 1 



5.10.10 PUTCH • Alternate version of PUTCHX 

PUTCH is like PUTCHX except it starts by setting the most significant bit of A 
to zero and that if A then contains aspace (040) it immediately returns zero true; in 
which case A is not stored, HL not incremented, and E not decremented. 



Entry point: 
Parameters: 



013430 



same as PUTCHX 



Exit conditions: same as PUTCHX except as described above 

5.10.11 PUTNAIM - format a filename from directory 

PUTNAM is a routine which extracts a name, extension and physical file number 
for a directory entry and puts them Into a place in the command interpreter called 
'NAME' (located at 013513; the field is 19 bytes long and followed by an 03.) Since 
this routine is used by the CAT command, the format of the names produced by 
PUTNAM should be familiar to all DOS users. 

Note that o entry, only the mo^X significant 4 bits of C are used, and that 
CURLOC (location 013463) is to contain the two-byte PDA of the directory sector 
(LSB,MSB). 



Entry point: 



013436 
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Exit conditions: 



Parameters: the directory sector In the disk buffer 

B =LFN indicating which buffer 
C =PFN of entry being extracted 
CURLOC =PDA of directory sector 

CURLOC unchanged 
disk buffer unchanged 
B unchanged 

all other registers indeterminate 
ZERO TRUE: file either does not exist 
or was created by PFN and therefore 
has no name. 

5.10.12 MOVSYM - obtain the symbol scanned by GETSYM 

MOVSYM moves the eight-byte SYMBOL described in 5.10.4 into the eight-byte 
area pointed to by DE. 



Entry point: 



013441 



Parameters: 



D.E =address of user's eight-byte area 



Exit conditions; All registers indeterminate 5.10.13 GETDBA - Obtain disk 

controller buffer address GETDBA extracts the current disk buffer address in the 
format acceptable to GETR$ from one of the four LFT entries. It does this by getting 
the BUFADR from the specified LFT entry and subtracting three from it. On return, H 
is the address MSB pointing into the command interpreter data area. 



Entry point: 



013444 



Parameters: 



Exit conditions: 



B =LFN (0,16,32,48) 

A =BUFADR as described above 
H as described above 
B,C,D,E unchanged 

5.11 User Supported InputOutput 

Wh^n the user desires to use I/O devices other than the keyboard, display, disk, 
or cassettes, he will use a routine that is not part of the operating system. Many of 
these devices (for instance, the communications channel) will be serviced by 
foreground processes which run with interrupts disabled. However, if the user does 
access an I/O device from a background process, he must realize that as long as 
interrupts are enabled, some other device can be addressed by a foreground routine. 
For this reason, the user must disable interrupts between the time he addresses his 
device and the time he uses it. To reduce the amount of foreground processing real 
time jitter (discussed in section four) as much as possible, the aim in writing 
background I/O routines should be to minimize the amount of time that interrupts are 
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disabled. This implies that devices accessed from background programs must be 
addressed every time they are used. For example: 



GETCH 



El 




Enable Interrupts 


LA 


022 


looping 


Dl 




Disable interrupts 


EX 


ADR 


Address the device 


IN 




Get the device status 


ND 


2 


Check for required bits 


JTZ 


GETCH 


Wait if not set 


EX 


DATA 


Else get the byte 


El 




Enable interrupts after 


IN 




the data input 


RET 







• n 



case 



Note that a little cheating on time was done in the interest of program length. (Since 
the INPUT in DATA mode was done without enabling interrupts, re-disabling them and 
re-addressing the device.) One should be judicious in the trade off employed in 
exercising this freedom. 

Note: The user must not do I/O to the disk controller from foreground-driven 
routines or results can be unpredictable. The DOS disk drivers allow user foreground 
routines to get control in the midst of a disk I/O operation, under te assumption that 
the foreground routine will not do anything to the disk controller which would confuse 
it. 
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SECTION 6. ERROR MESSAGES 



PARITY FAILURE DURING READ 

A parity fault occurred while a disk data record was being read. 

PARITY FAILURE DURING WRITE 

A parity fault occurred while a disk data record was being written. 

RECORD FORMAT ERROR 

The physical file number or logical record number in the record read did not 
match the values contained in the logical file table. 

RECORD NUMBER OUT OF RANGE 

The record accessed had a logical record number less than zero or, during 
reads, was outside the physical space allocated to the file. 

WRITE PROTECT VIOLATION 

An attempt was made to write on a file that had its write protection bit set. 

DELETE PROTECT VIOLATION 

An attempt was made to delete a file that had either its write or delete 
protection bit set. 

FILE SPACE FULL 

An attempt was made to allocate space when either the disk was physically full 
or no more segment descriptor slots were available in the RIB for the given file. 

DRIVE OFF LINE 

The drive went off line after the file was opened. 

LOGICAL FILE NOT OPEN 

An attempt was made to use an entry in the logical file table that was not 
opened for use with some file. 

INVALID LOGICAL FILE NUMBER 

A routine was called with the logical file number parameter not zero through 
three. 

INVALID DRIVE NUMBER 

A routine was called with the drive number not zero through the defined drive 
number limit (or 0377, if allowed). 
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INVALID TRAP NUMBER 

The TRAPS routine was called with a trap number not between zero and seven. 

FAILURE IN SYSTEM DATA 

An unrecoverable parity error occurred while the system was dealing with one 
of the disk tables or a retrieval information block, or a RIB with incorrect format 
was accessed. 

INVALID PHYSICAL FILE NUMBER 

A physical file number reserved for the system was illegally referenced. 

THE WORLD HAS COME TO AN END 

The erro^ message routine was parameterized with an invalid error message 
number! 

ERROR X ON DECK Y 

A cassette routine error has occurred. The X indicates the type of error 
according to the following table: 

D - parity error 
E - end of tape 
F - end of file 
G - unfindable file 
Z - write failure 
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Loader Routines 
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01000 


BOOTS 


01003 


RUNXS 


01006 


LOADXS 


01011 


INCHL 


01022 


DECHL 


01047 


GETNCH 


01052 


DR$ 


01055 


DW$ 


01060 


DSKWAT 



reload the operating system 
load and run a file by number 
load a file by number 
increment HL 
decrement HL 

get the next disk buffer byte 
read a sector into the disk buffer 
write a sector from the disk buffer 
wait for disk ready 



Foreground Routines 



01033 


CS$ 


01036 


TP$ 


01041 


SETI$ 


01044 


CLRI$ 



File Handling Routines 



change process state 
terminate process 
initiate foreground process 
terminate foreground process 



Symbolic File Referencing 



01063 


PREPS 


open or create a file 


01066 


OPENS 


open an existing file 


01071 


LOADS 


load a file by name 


01074 


RUNS 


load and run a file by name 



Logical File Referencing 



01077 


CLOSES 


01102 


CHOPS 


01105 


PROTES 


01110 


POSITS 


01113 


READS 


01116 


WRITES 


01121 


GETS 


01124 


GETRS 


01127 


PUTS 


01132 


PUTRS 


01135 


BSPS 



close a file 

delete space in a file 

change the protection on a file 

position to a record within a file 

read a record into the buffer 

write a record from the buffer 

get the next buffer character 

get an indexed buffer character 

store into the next buffer position 

store into an indexed buffer position 

backspace one record 
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Non-file referencing 



01143 


BLKTFR 


01146 


TRAPS 


01151 


EXITS 



transfer a block of memory 
set a disk error condition trap 
reload the operating system 



Keyboard and Display Routines 



01154 


DEBUGS 


01157 


KEVINS 


01162 


DSPLYS 



enter the debugging tool 
obtain a line from the keyboard 
display a line on the screen 



Cassette Handling Routines 



010000 


TPBOFS 


010005 


TPEOFS 


010012 


TRWS 


010017 


TBSPS 


010024 


TWBLKS 


010031 


TR$ 


010034 


TREADS 


010037 


TW$ 


010042 


TWRITS 


010045 


TFMRS 


010050 


TFMWS 


010053 


TTRAPS 


010056 


TWAITS 


010061 


TCHKS 



position to the beginning of a file 
position to the end of a file 
physically rewind a cassette 
physically backspace one record 
write an unformatted block 
read a numeric CTOS record 
TRS and wait for last character 
write a numeric CTOS record 
TW$ and wait for last character 
read the next file marker record 
write a file marker record 
set a cassette error trap 
wait for I/O completion 
get I/O status 
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SECTION 8.0 EVERYTHING YOU ALWAYS WANTTED TO KNOW ABOUT DOS 



Q. When I write my program, where should I place It in memory? 

A. The best address to specify in your SET statement in an assembly language program is 
017000. This allows your program full access to the routines in the DOS command 
interpreter and allows your program to return to the DOS through the NXTCMD and 
CMDAGN efTtry points. If the 8.5 K remaining above 017000 is inadequate for your 
program's needs, you could start your program at 010000 (assuming your program will 
not be using the DOS cassette handling routines.) 



Q. Where should I put the data areas used by my program, at the beginning or at the end? 

A. Experience in programming the Datapoint computers has found that generally it is best to 
put program data areas before the program itself. One advantage of this approach stems 
from the fact that programs can often be made shorter If most or all of the most 
commonly used data items are contained within one page of memory, eliminating the 
need to reload the H register as often. Since programs typically start on a page 
boundary, this automatically means that the first 256 bytes of your data area will be in 
one common page. Another advantage of this approach is that a person reading a 
program is frequently aided by seeing the program's data area and error messages, etc., 
before he plunges into the code itself. This placement also reduces the number of 
forward references the assembler must contend with. 



Q. When my program gets control from the DOS, do I need to save the registers so I can 

restore them before returning to it? 
A. No. Under the DOS the saving and restoring of the system's registers by user programs 

is not necessary. 



Q. Talking about returning to the DOS, how should my program do that? 

A. When a user program finishes, the normal termination is by jumping to EXIT$. 



Q. Does it matter if my program returns to the DOS (to EXITS, NXTCf^D, CMDAGN, or 
whereever) with the stack at a different level than when my program started? In other 
words, if my program calls several levels down into subroutines and the subroutine 
jumps to EXITS, will that mess things all up? 

A. No. Since the stack wraps around, the level is always relative and it makes no difference 
what is in the stack when the user returns control to the DOS. 
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Q, What is the best way to pass parameters to my subroutines? Is there any official 
convention for this? 

A. There is no 'official convention' for parameter passing. How/ever, experience with 

programming under the DOS suggests that passing parameters in the registers as typified 
by the DOS file handling routine parameterization is both efficient and convenient to use, 
The DOS convention that abnormal returns from subroutines are indicated by carry being 
true on exit (and further information indicated by the zero condition being true or false) 
also has proven to be a very handy technique, and one which user programs can 
probably make profitable example of. 



If you have had questions that may be helpful to others, please forward them to the 
Software Development Group, Datapoint Corporation so that they may be considered for use 
in subsequent releases of the DOS User's Guide. 
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